@memberjunction/actions-bizapps-social 2.61.0

package/dist/providers/facebook/actions/boost-post.action.js

@@ -0,0 +1,340 @@
+"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.FacebookBoostPostAction = void 0;
+const global_1 = require("@memberjunction/global");
+const facebook_base_action_1 = require("../facebook-base.action");
+const core_1 = require("@memberjunction/core");
+const axios_1 = __importDefault(require("axios"));
+/**
+ * Boosts (promotes) a Facebook post to reach a wider audience.
+ * Creates a simple ad campaign to increase post visibility.
+ */
+let FacebookBoostPostAction = class FacebookBoostPostAction extends facebook_base_action_1.FacebookBaseAction {
+    /**
+     * Get action description
+     */
+    get Description() {
+        return 'Boosts (promotes) a Facebook post to reach a wider audience through paid advertising';
+    }
+    /**
+     * Define the parameters for this action
+     */
+    get Params() {
+        return [
+            ...this.commonSocialParams,
+            {
+                Name: 'PostID',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'AdAccountID',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'Budget',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'Duration',
+                Type: 'Input',
+                Value: 7,
+            },
+            {
+                Name: 'Objective',
+                Type: 'Input',
+                Value: 'POST_ENGAGEMENT',
+            },
+            {
+                Name: 'AudienceType',
+                Type: 'Input',
+                Value: 'AUTO',
+            },
+            {
+                Name: 'TargetingSpec',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'StartTime',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'CallToAction',
+                Type: 'Input',
+                Value: null,
+            }
+        ];
+    }
+    /**
+     * Execute the action
+     */
+    async InternalRunAction(params) {
+        const { Params, ContextUser } = params;
+        try {
+            // Validate required parameters
+            const companyIntegrationId = this.getParamValue(Params, 'CompanyIntegrationID');
+            const postId = this.getParamValue(Params, 'PostID');
+            const adAccountId = this.getParamValue(Params, 'AdAccountID');
+            const budget = this.getParamValue(Params, 'Budget');
+            if (!companyIntegrationId) {
+                return {
+                    Success: false,
+                    Message: 'CompanyIntegrationID is required',
+                    ResultCode: 'INVALID_TOKEN'
+                };
+            }
+            if (!postId) {
+                return {
+                    Success: false,
+                    Message: 'PostID is required',
+                    ResultCode: 'MISSING_REQUIRED_PARAM'
+                };
+            }
+            if (!adAccountId) {
+                return {
+                    Success: false,
+                    Message: 'AdAccountID is required',
+                    ResultCode: 'MISSING_REQUIRED_PARAM'
+                };
+            }
+            if (!budget || budget <= 0) {
+                return {
+                    Success: false,
+                    Message: 'Budget must be a positive number',
+                    ResultCode: 'INVALID_BUDGET'
+                };
+            }
+            // Initialize OAuth
+            if (!await this.initializeOAuth(companyIntegrationId)) {
+                return {
+                    Success: false,
+                    Message: 'Failed to initialize Facebook OAuth connection',
+                    ResultCode: 'INVALID_TOKEN'
+                };
+            }
+            // Get parameters
+            const duration = this.getParamValue(Params, 'Duration') || 7;
+            const objective = this.getParamValue(Params, 'Objective') || 'POST_ENGAGEMENT';
+            const audienceType = this.getParamValue(Params, 'AudienceType') || 'AUTO';
+            const targetingSpec = this.getParamValue(Params, 'TargetingSpec');
+            const startTime = this.getParamValue(Params, 'StartTime');
+            const callToAction = this.getParamValue(Params, 'CallToAction');
+            // Validate duration
+            if (duration < 1 || duration > 30) {
+                return {
+                    Success: false,
+                    Message: 'Duration must be between 1 and 30 days',
+                    ResultCode: 'INVALID_DURATION'
+                };
+            }
+            // Extract page ID from post ID
+            const pageId = postId.split('_')[0];
+            // Get page access token
+            const pageToken = await this.getPageAccessToken(pageId);
+            (0, core_1.LogStatus)(`Creating boost campaign for post ${postId}...`);
+            // Step 1: Create campaign
+            const campaignName = `Boost Post ${postId} - ${new Date().toISOString()}`;
+            const campaign = await this.createCampaign(adAccountId, campaignName, objective);
+            // Step 2: Create ad set with targeting
+            const adSetName = `Ad Set for ${postId}`;
+            const targeting = this.buildTargeting(audienceType, targetingSpec, pageId);
+            const adSet = await this.createAdSet(adAccountId, campaign.id, adSetName, budget, duration, targeting, startTime);
+            // Step 3: Create ad creative from post
+            const creative = await this.createCreativeFromPost(adAccountId, postId, pageToken, callToAction);
+            // Step 4: Create the ad
+            const adName = `Boosted Post ${postId}`;
+            const ad = await this.createAd(adAccountId, adSet.id, creative.id, adName);
+            // Get boost summary
+            const boostSummary = {
+                campaignId: campaign.id,
+                adSetId: adSet.id,
+                adId: ad.id,
+                creativeId: creative.id,
+                postId,
+                budget,
+                duration,
+                objective,
+                audienceType,
+                startTime: adSet.start_time,
+                endTime: adSet.end_time,
+                status: ad.status,
+                reviewStatus: ad.review_feedback?.global_review_status || 'PENDING',
+                previewUrl: `https://www.facebook.com/ads/manager/account/campaigns?act=${adAccountId}&selected_campaign_ids=${campaign.id}`
+            };
+            (0, core_1.LogStatus)(`Successfully created boost campaign for post ${postId}`);
+            return {
+                Success: true,
+                Message: 'Post boost created successfully',
+                ResultCode: 'SUCCESS',
+                Params
+            };
+        }
+        catch (error) {
+            (0, core_1.LogError)(`Failed to boost Facebook post: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            if (this.isAuthError(error)) {
+                return this.handleOAuthError(error);
+            }
+            // Check for specific ad-related errors
+            if (error instanceof Error) {
+                if (error.message.includes('permissions')) {
+                    return {
+                        Success: false,
+                        Message: 'Insufficient permissions. Ensure the token has ads_management permission.',
+                        ResultCode: 'INSUFFICIENT_PERMISSIONS'
+                    };
+                }
+                if (error.message.includes('budget')) {
+                    return {
+                        Success: false,
+                        Message: 'Invalid budget. Check minimum budget requirements for your currency.',
+                        ResultCode: 'INVALID_BUDGET'
+                    };
+                }
+            }
+            return {
+                Success: false,
+                Message: error instanceof Error ? error.message : 'Unknown error occurred',
+                ResultCode: 'ERROR'
+            };
+        }
+    }
+    /**
+     * Create a campaign
+     */
+    async createCampaign(adAccountId, name, objective) {
+        const response = await this.axiosInstance.post(`/${adAccountId}/campaigns`, {
+            name,
+            objective,
+            status: 'PAUSED', // Start paused for safety
+            special_ad_categories: [] // Required field
+        });
+        return response.data;
+    }
+    /**
+     * Create an ad set
+     */
+    async createAdSet(adAccountId, campaignId, name, budget, durationDays, targeting, startTime) {
+        const now = new Date();
+        const start = startTime ? new Date(startTime) : now;
+        const end = new Date(start);
+        end.setDate(end.getDate() + durationDays);
+        // Calculate daily budget
+        const dailyBudget = Math.ceil((budget * 100) / durationDays); // Convert to cents
+        const response = await this.axiosInstance.post(`/${adAccountId}/adsets`, {
+            name,
+            campaign_id: campaignId,
+            daily_budget: dailyBudget,
+            billing_event: 'IMPRESSIONS',
+            optimization_goal: this.getOptimizationGoal(campaignId),
+            bid_strategy: 'LOWEST_COST_WITHOUT_CAP',
+            targeting,
+            start_time: start.toISOString(),
+            end_time: end.toISOString(),
+            status: 'PAUSED'
+        });
+        return response.data;
+    }
+    /**
+     * Create creative from existing post
+     */
+    async createCreativeFromPost(adAccountId, postId, pageToken, callToAction) {
+        const creativeData = {
+            name: `Creative for ${postId}`,
+            object_story_id: postId
+        };
+        if (callToAction) {
+            // Get post details to add CTA
+            const postResponse = await axios_1.default.get(`${this.apiBaseUrl}/${postId}`, {
+                params: {
+                    access_token: pageToken,
+                    fields: 'permalink_url'
+                }
+            });
+            creativeData.call_to_action = {
+                type: callToAction,
+                value: {
+                    link: postResponse.data.permalink_url
+                }
+            };
+        }
+        const response = await this.axiosInstance.post(`/${adAccountId}/adcreatives`, creativeData);
+        return response.data;
+    }
+    /**
+     * Create the ad
+     */
+    async createAd(adAccountId, adSetId, creativeId, name) {
+        const response = await this.axiosInstance.post(`/${adAccountId}/ads`, {
+            name,
+            adset_id: adSetId,
+            creative: { creative_id: creativeId },
+            status: 'PAUSED'
+        });
+        return response.data;
+    }
+    /**
+     * Build targeting specification
+     */
+    buildTargeting(audienceType, customTargeting, pageId) {
+        const baseTargeting = {
+            geo_locations: {
+                countries: ['US'] // Default to US, can be overridden
+            }
+        };
+        switch (audienceType) {
+            case 'FANS':
+                baseTargeting.connections = [pageId];
+                break;
+            case 'FANS_AND_CONNECTIONS':
+                baseTargeting.connections = [pageId];
+                baseTargeting.friends_of_connections = [pageId];
+                break;
+            case 'CUSTOM':
+                if (customTargeting) {
+                    return { ...baseTargeting, ...customTargeting };
+                }
+                break;
+            case 'AUTO':
+            default:
+                // Facebook will automatically optimize targeting
+                break;
+        }
+        // Add any custom targeting on top
+        if (customTargeting && audienceType !== 'CUSTOM') {
+            Object.assign(baseTargeting, customTargeting);
+        }
+        return baseTargeting;
+    }
+    /**
+     * Get optimization goal based on objective
+     */
+    getOptimizationGoal(objective) {
+        const goalMap = {
+            'POST_ENGAGEMENT': 'POST_ENGAGEMENT',
+            'REACH': 'REACH',
+            'LINK_CLICKS': 'LINK_CLICKS',
+            'PAGE_LIKES': 'PAGE_LIKES',
+            'BRAND_AWARENESS': 'AD_RECALL_LIFT',
+            'VIDEO_VIEWS': 'VIDEO_VIEWS'
+        };
+        return goalMap[objective] || 'POST_ENGAGEMENT';
+    }
+};
+exports.FacebookBoostPostAction = FacebookBoostPostAction;
+exports.FacebookBoostPostAction = FacebookBoostPostAction = __decorate([
+    (0, global_1.RegisterClass)(facebook_base_action_1.FacebookBaseAction, 'FacebookBoostPostAction')
+], FacebookBoostPostAction);
+//# sourceMappingURL=boost-post.action.js.map

package/dist/providers/facebook/actions/boost-post.action.js.map

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

package/dist/providers/facebook/actions/create-album.action.d.ts

@@ -0,0 +1,33 @@
+import { FacebookBaseAction } from '../facebook-base.action';
+import { ActionParam, ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+/**
+ * Creates a photo album on a Facebook page and optionally uploads photos to it.
+ * Albums help organize related photos together.
+ */
+export declare class FacebookCreateAlbumAction extends FacebookBaseAction {
+    /**
+     * Get action description
+     */
+    get Description(): string;
+    /**
+     * Define the parameters for this action
+     */
+    get Params(): ActionParam[];
+    /**
+     * Execute the action
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Upload a photo to an album
+     */
+    private uploadPhotoToAlbum;
+    /**
+     * Set the cover photo for an album
+     */
+    private setAlbumCoverPhoto;
+    /**
+     * Get album details
+     */
+    private getAlbumDetails;
+}
+//# sourceMappingURL=create-album.action.d.ts.map

package/dist/providers/facebook/actions/create-album.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-album.action.d.ts","sourceRoot":"","sources":["../../../../src/providers/facebook/actions/create-album.action.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAiB,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMhG;;;GAGG;AACH,qBACa,yBAA0B,SAAQ,kBAAkB;IAC7D;;OAEG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,WAAW,EAAE,CAiDjC;IAED;;OAEG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8KvF;;OAEG;YACW,kBAAkB;IAuChC;;OAEG;YACW,kBAAkB;IAchC;;OAEG;YACW,eAAe;CAoBhC"}

package/dist/providers/facebook/actions/create-album.action.js

@@ -0,0 +1,285 @@
+"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.FacebookCreateAlbumAction = void 0;
+const global_1 = require("@memberjunction/global");
+const facebook_base_action_1 = require("../facebook-base.action");
+const core_1 = require("@memberjunction/core");
+const axios_1 = __importDefault(require("axios"));
+const form_data_1 = __importDefault(require("form-data"));
+/**
+ * Creates a photo album on a Facebook page and optionally uploads photos to it.
+ * Albums help organize related photos together.
+ */
+let FacebookCreateAlbumAction = class FacebookCreateAlbumAction extends facebook_base_action_1.FacebookBaseAction {
+    /**
+     * Get action description
+     */
+    get Description() {
+        return 'Creates a photo album on a Facebook page and optionally uploads photos to it';
+    }
+    /**
+     * Define the parameters for this action
+     */
+    get Params() {
+        return [
+            ...this.commonSocialParams,
+            {
+                Name: 'PageID',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'AlbumName',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'Description',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'Location',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'Privacy',
+                Type: 'Input',
+                Value: 'EVERYONE',
+            },
+            {
+                Name: 'Photos',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'PhotoCaptions',
+                Type: 'Input',
+                Value: null,
+            },
+            {
+                Name: 'CoverPhotoIndex',
+                Type: 'Input',
+                Value: 0,
+            },
+            {
+                Name: 'MakeAlbumPublic',
+                Type: 'Input',
+                Value: true,
+            }
+        ];
+    }
+    /**
+     * Execute the action
+     */
+    async InternalRunAction(params) {
+        const { Params, ContextUser } = params;
+        try {
+            // Validate required parameters
+            const companyIntegrationId = this.getParamValue(Params, 'CompanyIntegrationID');
+            const pageId = this.getParamValue(Params, 'PageID');
+            const albumName = this.getParamValue(Params, 'AlbumName');
+            if (!companyIntegrationId) {
+                return {
+                    Success: false,
+                    Message: 'CompanyIntegrationID is required',
+                    ResultCode: 'INVALID_TOKEN'
+                };
+            }
+            if (!pageId) {
+                return {
+                    Success: false,
+                    Message: 'PageID is required',
+                    ResultCode: 'MISSING_REQUIRED_PARAM'
+                };
+            }
+            if (!albumName) {
+                return {
+                    Success: false,
+                    Message: 'AlbumName is required',
+                    ResultCode: 'MISSING_REQUIRED_PARAM'
+                };
+            }
+            // Initialize OAuth
+            if (!await this.initializeOAuth(companyIntegrationId)) {
+                return {
+                    Success: false,
+                    Message: 'Failed to initialize Facebook OAuth connection',
+                    ResultCode: 'INVALID_TOKEN'
+                };
+            }
+            // Get parameters
+            const description = this.getParamValue(Params, 'Description');
+            const location = this.getParamValue(Params, 'Location');
+            const privacy = this.getParamValue(Params, 'Privacy');
+            const photos = this.getParamValue(Params, 'Photos');
+            const photoCaptions = this.getParamValue(Params, 'PhotoCaptions');
+            const coverPhotoIndex = this.getParamValue(Params, 'CoverPhotoIndex') || 0;
+            const makeAlbumPublic = this.getParamValue(Params, 'MakeAlbumPublic') !== false;
+            // Validate photos are images
+            if (photos && photos.length > 0) {
+                for (const photo of photos) {
+                    if (!photo.mimeType.startsWith('image/')) {
+                        return {
+                            Success: false,
+                            Message: `Only image files are allowed in albums. File ${photo.filename} is ${photo.mimeType}`,
+                            ResultCode: 'INVALID_MEDIA'
+                        };
+                    }
+                }
+            }
+            (0, core_1.LogStatus)(`Creating album "${albumName}" on Facebook page ${pageId}...`);
+            // Get page access token
+            const pageToken = await this.getPageAccessToken(pageId);
+            // Create the album
+            const albumData = {
+                name: albumName,
+                privacy: {
+                    value: privacy
+                }
+            };
+            if (description) {
+                albumData.message = description;
+            }
+            if (location) {
+                albumData.location = location;
+            }
+            const albumResponse = await axios_1.default.post(`${this.apiBaseUrl}/${pageId}/albums`, albumData, {
+                params: {
+                    access_token: pageToken
+                }
+            });
+            const albumId = albumResponse.data.id;
+            (0, core_1.LogStatus)(`Album created with ID: ${albumId}`);
+            // Upload photos if provided
+            const uploadedPhotos = [];
+            let coverPhotoId = null;
+            if (photos && photos.length > 0) {
+                (0, core_1.LogStatus)(`Uploading ${photos.length} photos to the album...`);
+                for (let i = 0; i < photos.length; i++) {
+                    const photo = photos[i];
+                    const caption = photoCaptions?.[i] || '';
+                    try {
+                        const photoId = await this.uploadPhotoToAlbum(albumId, photo, caption, pageToken, !makeAlbumPublic // Keep unpublished if album is not public yet
+                        );
+                        uploadedPhotos.push({
+                            id: photoId,
+                            filename: photo.filename,
+                            caption
+                        });
+                        if (i === coverPhotoIndex) {
+                            coverPhotoId = photoId;
+                        }
+                        (0, core_1.LogStatus)(`Uploaded photo ${i + 1}/${photos.length}: ${photo.filename}`);
+                    }
+                    catch (error) {
+                        (0, core_1.LogError)(`Failed to upload photo ${photo.filename}: ${error}`);
+                        // Continue with other photos
+                    }
+                }
+            }
+            // Set cover photo if specified and photos were uploaded
+            if (coverPhotoId) {
+                try {
+                    await this.setAlbumCoverPhoto(albumId, coverPhotoId, pageToken);
+                    (0, core_1.LogStatus)(`Set cover photo for album`);
+                }
+                catch (error) {
+                    (0, core_1.LogError)(`Failed to set cover photo: ${error}`);
+                    // Non-critical error, continue
+                }
+            }
+            // Get the final album details
+            const album = await this.getAlbumDetails(albumId, pageToken);
+            (0, core_1.LogStatus)(`Album "${albumName}" created successfully with ${uploadedPhotos.length} photos`);
+            return {
+                Success: true,
+                Message: `Album created successfully with ${uploadedPhotos.length} photos`,
+                ResultCode: 'SUCCESS',
+                Params
+            };
+        }
+        catch (error) {
+            (0, core_1.LogError)(`Failed to create Facebook album: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            if (this.isAuthError(error)) {
+                return this.handleOAuthError(error);
+            }
+            return {
+                Success: false,
+                Message: error instanceof Error ? error.message : 'Unknown error occurred',
+                ResultCode: 'ERROR'
+            };
+        }
+    }
+    /**
+     * Upload a photo to an album
+     */
+    async uploadPhotoToAlbum(albumId, photo, caption, pageToken, unpublished = false) {
+        const fileData = typeof photo.data === 'string'
+            ? Buffer.from(photo.data, 'base64')
+            : photo.data;
+        const formData = new form_data_1.default();
+        formData.append('source', fileData, {
+            filename: photo.filename,
+            contentType: photo.mimeType
+        });
+        if (caption) {
+            formData.append('message', caption);
+        }
+        if (unpublished) {
+            formData.append('published', 'false');
+        }
+        const response = await axios_1.default.post(`${this.apiBaseUrl}/${albumId}/photos`, formData, {
+            headers: formData.getHeaders(),
+            params: {
+                access_token: pageToken
+            }
+        });
+        return response.data.id;
+    }
+    /**
+     * Set the cover photo for an album
+     */
+    async setAlbumCoverPhoto(albumId, photoId, pageToken) {
+        await axios_1.default.post(`${this.apiBaseUrl}/${albumId}`, {
+            cover_photo: photoId
+        }, {
+            params: {
+                access_token: pageToken
+            }
+        });
+    }
+    /**
+     * Get album details
+     */
+    async getAlbumDetails(albumId, pageToken) {
+        try {
+            const response = await axios_1.default.get(`${this.apiBaseUrl}/${albumId}`, {
+                params: {
+                    access_token: pageToken,
+                    fields: 'id,name,description,link,cover_photo,count,created_time,photos.limit(1){id,images}'
+                }
+            });
+            return response.data;
+        }
+        catch (error) {
+            (0, core_1.LogError)(`Failed to get album details: ${error}`);
+            return null;
+        }
+    }
+};
+exports.FacebookCreateAlbumAction = FacebookCreateAlbumAction;
+exports.FacebookCreateAlbumAction = FacebookCreateAlbumAction = __decorate([
+    (0, global_1.RegisterClass)(facebook_base_action_1.FacebookBaseAction, 'FacebookCreateAlbumAction')
+], FacebookCreateAlbumAction);
+//# sourceMappingURL=create-album.action.js.map