@rempays/shared-core 1.0.2-beta.12 → 1.0.2-beta.14

package/dist/facebook-api/facebook.d.ts

@@ -1,8 +1,10 @@
-import type { SendTextParams, SendTemplateParams, SendInteractiveParams, SendInteractiveListParams, SendImageParams, SendDocumentParams, SendLocationParams, SetTypingParams, MarkAsReadParams } from './types';
+import type { SendTextParams, SendTemplateParams, SendInteractiveParams, SendInteractiveListParams, SendImageParams, SendDocumentParams, SendLocationParams, SetTypingParams, MarkAsReadParams, SendAudioParams, SendVideoParams, MediaInfoResponse, CreateTemplateParams, BusinessProfileParams, BusinessProfileResponse, UpdateDisplayNameParams, DisplayNameStatusResponse } from "./types";
 export declare class FacebookApi {
     private static token;
     private static phoneNumberId;
     private static apiVersion;
+    private static appId;
+    constructor(token?: string, phoneNumberId?: string, apiVersion?: string, appId?: string);
     private static init;
     private static post;
     static sendText(params: SendTextParams): Promise<any>;
@@ -11,7 +13,33 @@ export declare class FacebookApi {
     static sendInteractiveList(params: SendInteractiveListParams): Promise<any>;
     static sendImage(params: SendImageParams): Promise<any>;
     static sendDocument(params: SendDocumentParams): Promise<any>;
+    static sendAudio(params: SendAudioParams): Promise<any>;
+    static sendVideo(params: SendVideoParams): Promise<any>;
     static sendLocation(params: SendLocationParams): Promise<any>;
     static setTyping(params: SetTypingParams): Promise<any>;
     static markAsRead(params: MarkAsReadParams): Promise<any>;
+    static getMediaInfo(mediaId: string): Promise<MediaInfoResponse>;
+    static downloadMedia(mediaId: string): Promise<Buffer>;
+    static buildGoogleMapsUrl(latitude: number, longitude: number): string;
+    static listTemplates(wabaId: string): Promise<any>;
+    static createTemplate(params: CreateTemplateParams): Promise<any>;
+    static deleteTemplate(wabaId: string, name: string): Promise<any>;
+    /**
+     * Uploads an image and updates the business profile picture.
+     * @param buffer Image binary data
+     * @param mimeType Image MIME type (image/jpeg or image/png)
+     */
+    static updateProfilePicture(buffer: Buffer, mimeType: string): Promise<any>;
+    /**
+     * Uploads media for chat (messages).
+     * @param buffer Media binary data
+     * @param mimeType MIME type of the file
+     */
+    static uploadMedia(buffer: Buffer, mimeType: string): Promise<{
+        id: string;
+    }>;
+    static getBusinessProfile(): Promise<BusinessProfileResponse>;
+    static updateBusinessProfile(params: BusinessProfileParams): Promise<any>;
+    static updateDisplayName(params: UpdateDisplayNameParams): Promise<any>;
+    static getDisplayNameStatus(): Promise<DisplayNameStatusResponse>;
 }

package/dist/facebook-api/facebook.js

@@ -3,12 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FacebookApi = void 0;
 const http_1 = require("./http");
 class FacebookApi {
+    constructor(token, phoneNumberId, apiVersion, appId) {
+        if (token)
+            FacebookApi.token = token;
+        if (phoneNumberId)
+            FacebookApi.phoneNumberId = phoneNumberId;
+        if (apiVersion)
+            FacebookApi.apiVersion = apiVersion;
+        if (appId)
+            FacebookApi.appId = appId;
+    }
     static async init() {
         if (this.token && this.phoneNumberId && this.apiVersion)
             return;
-        this.token = process.env.FACEBOOK_API_TOKEN || null;
-        this.phoneNumberId = process.env.FACEBOOK_PHONE_NUMBER_ID || null;
-        this.apiVersion = process.env.FACEBOOK_API_VERSION || 'v18.0';
+        this.token = this.token || process.env.FACEBOOK_API_TOKEN || null;
+        this.phoneNumberId =
+            this.phoneNumberId || process.env.FACEBOOK_PHONE_NUMBER_ID || null;
+        this.apiVersion =
+            this.apiVersion || process.env.FACEBOOK_API_VERSION || "v18.0";
+        this.appId = this.appId || process.env.FACEBOOK_APP_ID || null;
         if (!this.token || !this.phoneNumberId) {
             throw new Error("Facebook API environment variables are not properly configured (FACEBOOK_API_TOKEN, FACEBOOK_PHONE_NUMBER_ID)");
         }
@@ -37,16 +50,25 @@ class FacebookApi {
             throw new Error(msg);
         }
     }
+    /*
+    TEXT
+    */
     static async sendText(params) {
         const payload = {
             messaging_product: "whatsapp",
             recipient_type: "individual",
             to: params.to,
             type: "text",
-            text: { body: params.body, preview_url: params.previewUrl ?? true },
+            text: {
+                body: params.body,
+                preview_url: params.previewUrl ?? true,
+            },
         };
         return await this.post("messages", payload);
     }
+    /*
+    TEMPLATE
+    */
     static async sendTemplate(params) {
         const payload = {
             messaging_product: "whatsapp",
@@ -60,6 +82,9 @@ class FacebookApi {
         };
         return await this.post("messages", payload);
     }
+    /*
+    BUTTONS
+    */
     static async sendInteractiveButtons(params) {
         const payload = {
             messaging_product: "whatsapp",
@@ -80,6 +105,9 @@ class FacebookApi {
         };
         return await this.post("messages", payload);
     }
+    /*
+    LIST
+    */
     static async sendInteractiveList(params) {
         const payload = {
             messaging_product: "whatsapp",
@@ -109,15 +137,25 @@ class FacebookApi {
         }
         return await this.post("messages", payload);
     }
+    /*
+    IMAGE
+    */
     static async sendImage(params) {
         const payload = {
             messaging_product: "whatsapp",
             to: params.to,
             type: "image",
-            image: { link: params.link, caption: params.caption },
+            image: {
+                link: params.link,
+                id: params.id,
+                caption: params.caption
+            },
         };
         return await this.post("messages", payload);
     }
+    /*
+    DOCUMENT
+    */
     static async sendDocument(params) {
         const payload = {
             messaging_product: "whatsapp",
@@ -125,12 +163,47 @@ class FacebookApi {
             type: "document",
             document: {
                 link: params.link,
+                id: params.id,
                 caption: params.caption,
                 filename: params.filename,
             },
         };
         return await this.post("messages", payload);
     }
+    /*
+    AUDIO (NEW)
+    */
+    static async sendAudio(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            to: params.to,
+            type: "audio",
+            audio: {
+                link: params.link,
+                id: params.id,
+            },
+        };
+        return await this.post("messages", payload);
+    }
+    /*
+    VIDEO (NEW)
+    */
+    static async sendVideo(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            to: params.to,
+            type: "video",
+            video: {
+                link: params.link,
+                id: params.id,
+                caption: params.caption,
+            },
+        };
+        return await this.post("messages", payload);
+    }
+    /*
+    LOCATION
+    */
     static async sendLocation(params) {
         const payload = {
             messaging_product: "whatsapp",
@@ -145,6 +218,9 @@ class FacebookApi {
         };
         return await this.post("messages", payload);
     }
+    /*
+    TYPING
+    */
     static async setTyping(params) {
         const payload = {
             messaging_product: "whatsapp",
@@ -154,6 +230,9 @@ class FacebookApi {
         };
         return await this.post("messages", payload);
     }
+    /*
+    READ
+    */
     static async markAsRead(params) {
         const payload = {
             messaging_product: "whatsapp",
@@ -162,8 +241,182 @@ class FacebookApi {
         };
         return await this.post("messages", payload);
     }
+    /*
+    MEDIA INFO (NEW)
+    */
+    static async getMediaInfo(mediaId) {
+        await this.init();
+        const http = (0, http_1.getHttpClient)(this.token);
+        const url = `https://graph.facebook.com/${this.apiVersion}/${mediaId}`;
+        const { data } = await http.get(url);
+        return data;
+    }
+    /*
+    DOWNLOAD MEDIA (NEW)
+    */
+    static async downloadMedia(mediaId) {
+        await this.init();
+        const media = await this.getMediaInfo(mediaId);
+        const http = (0, http_1.getHttpClient)(this.token);
+        const { data } = await http.get(media.url, {
+            responseType: "arraybuffer",
+        });
+        return data;
+    }
+    /*
+    GOOGLE MAP URL (NEW)
+    */
+    static buildGoogleMapsUrl(latitude, longitude) {
+        return `https://www.google.com/maps?q=${latitude},${longitude}`;
+    }
+    static async listTemplates(wabaId) {
+        await this.init();
+        const http = (0, http_1.getHttpClient)(this.token);
+        const url = `https://graph.facebook.com/${this.apiVersion}/${wabaId}/message_templates`;
+        const { data } = await http.get(url);
+        return data;
+    }
+    static async createTemplate(params) {
+        await this.init();
+        const http = (0, http_1.getHttpClient)(this.token);
+        const url = `https://graph.facebook.com/${this.apiVersion}/${params.wabaId}/message_templates`;
+        const payload = {
+            name: params.name,
+            category: params.category,
+            language: params.language,
+            components: [
+                {
+                    type: "BODY",
+                    text: params.bodyText
+                }
+            ]
+        };
+        const { data } = await http.post(url, payload);
+        return data;
+    }
+    static async deleteTemplate(wabaId, name) {
+        await this.init();
+        const http = (0, http_1.getHttpClient)(this.token);
+        const url = `https://graph.facebook.com/${this.apiVersion}/${wabaId}/message_templates`;
+        const { data } = await http.delete(url, {
+            params: { name }
+        });
+        return data;
+    }
+    /*
+    PROFILE PICTURE UPLOAD (TWO-STEP)
+    */
+    /**
+     * Uploads an image and updates the business profile picture.
+     * @param buffer Image binary data
+     * @param mimeType Image MIME type (image/jpeg or image/png)
+     */
+    static async updateProfilePicture(buffer, mimeType) {
+        await this.init();
+        if (!this.appId) {
+            throw new Error("FACEBOOK_APP_ID is required for profile picture uploads");
+        }
+        const http = (0, http_1.getHttpClient)(this.token);
+        // 1. Create upload session
+        const sessionUrl = `https://graph.facebook.com/${this.apiVersion}/${this.appId}/uploads`;
+        const { data: sessionData } = await http.post(sessionUrl, null, {
+            params: {
+                file_length: buffer.length,
+                file_type: mimeType,
+                access_token: this.token
+            }
+        });
+        const sessionId = sessionData.id;
+        // 2. Upload the file data
+        const uploadUrl = `https://graph.facebook.com/${this.apiVersion}/${sessionId}`;
+        const { data: uploadData } = await http.post(uploadUrl, buffer, {
+            headers: {
+                'file_offset': 0,
+                'Content-Type': mimeType
+            }
+        });
+        const handle = uploadData.h;
+        // 3. Update the business profile with the handle
+        return await this.updateBusinessProfile({
+            profile_picture_handle: handle
+        });
+    }
+    /*
+    CHAT MEDIA UPLOAD
+    */
+    /**
+     * Uploads media for chat (messages).
+     * @param buffer Media binary data
+     * @param mimeType MIME type of the file
+     */
+    static async uploadMedia(buffer, mimeType) {
+        await this.init();
+        const http = (0, http_1.getHttpClient)(this.token);
+        const url = `https://graph.facebook.com/${this.apiVersion}/${this.phoneNumberId}/media`;
+        const formData = new FormData();
+        const blob = new Blob([buffer], { type: mimeType });
+        formData.append('file', blob, 'media');
+        formData.append('type', mimeType);
+        formData.append('messaging_product', 'whatsapp');
+        const { data } = await http.post(url, formData, {
+            headers: {
+                'Content-Type': 'multipart/form-data'
+            }
+        });
+        return data; // Returns { id: "media_id" }
+    }
+    /*
+    BUSINESS PROFILE
+    */
+    static async getBusinessProfile() {
+        await this.init();
+        const http = (0, http_1.getHttpClient)(this.token);
+        const url = `https://graph.facebook.com/${this.apiVersion}/${this.phoneNumberId}/whatsapp_business_profile`;
+        const { data } = await http.get(url, {
+            params: {
+                fields: "about,address,description,email,profile_picture_url,websites,vertical"
+            }
+        });
+        // The response is usually { data: [ { ... } ] }
+        return data.data?.[0] || data;
+    }
+    static async updateBusinessProfile(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            ...params
+        };
+        return await this.post("whatsapp_business_profile", payload);
+    }
+    /*
+    DISPLAY NAME
+    */
+    static async updateDisplayName(params) {
+        await this.init();
+        const http = (0, http_1.getHttpClient)(this.token);
+        // Using phone number ID directly with query params as per Meta documentation
+        const url = `https://graph.facebook.com/${this.apiVersion}/${this.phoneNumberId}`;
+        const { data } = await http.post(url, null, {
+            params: {
+                new_display_name: params.new_display_name
+            }
+        });
+        return data;
+    }
+    static async getDisplayNameStatus() {
+        await this.init();
+        const http = (0, http_1.getHttpClient)(this.token);
+        // Using phone number ID to get status of display names
+        const url = `https://graph.facebook.com/${this.apiVersion}/${this.phoneNumberId}`;
+        const { data } = await http.get(url, {
+            params: {
+                fields: "verified_name,name_status,new_display_name,new_name_status"
+            }
+        });
+        return data;
+    }
 }
 exports.FacebookApi = FacebookApi;
 FacebookApi.token = null;
 FacebookApi.phoneNumberId = null;
 FacebookApi.apiVersion = null;
+FacebookApi.appId = null;

package/dist/facebook-api/types.d.ts

@@ -7,7 +7,13 @@ export interface SendTemplateParams {
     to: string;
     name: string;
     languageCode: string;
-    components?: any[];
+    components?: Array<{
+        type: "header" | "body" | "button";
+        parameters?: Array<{
+            type: "text" | "image" | "document" | "video";
+            text?: string;
+        }>;
+    }>;
 }
 export interface SendInteractiveParams {
     to: string;
@@ -43,12 +49,14 @@ export interface SendInteractiveListParams {
 }
 export interface SendImageParams {
     to: string;
-    link: string;
+    link?: string;
+    id?: string;
     caption?: string;
 }
 export interface SendDocumentParams {
     to: string;
-    link: string;
+    link?: string;
+    id?: string;
     filename?: string;
     caption?: string;
 }
@@ -107,3 +115,57 @@ export interface PhoneNumberInfo {
     quality_rating?: string;
     code_verification_status?: string;
 }
+export interface SendAudioParams {
+    to: string;
+    link?: string;
+    id?: string;
+}
+export interface SendVideoParams {
+    to: string;
+    link?: string;
+    id?: string;
+    caption?: string;
+}
+export interface MediaInfoResponse {
+    url: string;
+    mime_type: string;
+    sha256: string;
+    file_size: number;
+}
+export interface CreateTemplateParams {
+    wabaId: string;
+    name: string;
+    category: "MARKETING" | "UTILITY" | "AUTHENTICATION";
+    language: string;
+    bodyText: string;
+}
+export interface BusinessProfileParams {
+    about?: string;
+    address?: string;
+    description?: string;
+    email?: string;
+    websites?: string[];
+    vertical?: WhatsAppBusinessVertical;
+    profile_picture_handle?: string;
+}
+export type WhatsAppBusinessVertical = "" | "UNDEFINED" | "OTHER" | "AUTO" | "BEAUTY" | "APPAREL" | "EDU" | "ENTERTAIN" | "EVENT_PLAN" | "FINANCE" | "GROCERY" | "GOVT" | "HOTEL" | "HEALTH" | "NONPROFIT" | "PROF_SERVICES" | "RETAIL" | "TRAVEL" | "RESTAURANT" | "NOT_A_BIZ";
+export interface BusinessProfileResponse {
+    messaging_product: "whatsapp";
+    about: string;
+    address: string;
+    description: string;
+    email: string;
+    websites: string[];
+    vertical: WhatsAppBusinessVertical;
+    profile_picture_url?: string;
+}
+export interface UpdateDisplayNameParams {
+    new_display_name: string;
+}
+export interface DisplayNameStatusResponse {
+    verified_name: string;
+    name_status: string;
+    new_display_name?: string;
+    new_name_status?: string;
+    id: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rempays/shared-core",
-    "version": "1.0.2-beta.12",
+    "version": "1.0.2-beta.14",
     "description": "Core utilities layer for RemPays platform with AWS services integration (Cognito, S3, Secrets Manager, Textract, Facebook API, DynamoDB)",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",