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

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

@@ -1,9 +1,10 @@
-import type { SendTextParams, SendTemplateParams, SendInteractiveParams, SendInteractiveListParams, SendImageParams, SendDocumentParams, SendLocationParams, SetTypingParams, MarkAsReadParams, SendAudioParams, SendVideoParams, MediaInfoResponse, CreateTemplateParams } 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;
-    constructor(token?: string, phoneNumberId?: string, apiVersion?: string);
+    private static appId;
+    constructor(token?: string, phoneNumberId?: string, apiVersion?: string, appId?: string);
     private static init;
     private static post;
     static sendText(params: SendTextParams): Promise<any>;
@@ -23,4 +24,22 @@ export declare class FacebookApi {
     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,13 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FacebookApi = void 0;
 const http_1 = require("./http");
 class FacebookApi {
-    constructor(token, phoneNumberId, apiVersion) {
+    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)
@@ -19,6 +21,7 @@ class FacebookApi {
             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)");
         }
@@ -142,7 +145,11 @@ class FacebookApi {
             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);
     }
@@ -156,6 +163,7 @@ class FacebookApi {
             type: "document",
             document: {
                 link: params.link,
+                id: params.id,
                 caption: params.caption,
                 filename: params.filename,
             },
@@ -172,6 +180,7 @@ class FacebookApi {
             type: "audio",
             audio: {
                 link: params.link,
+                id: params.id,
             },
         };
         return await this.post("messages", payload);
@@ -186,6 +195,7 @@ class FacebookApi {
             type: "video",
             video: {
                 link: params.link,
+                id: params.id,
                 caption: params.caption,
             },
         };
@@ -293,8 +303,120 @@ class FacebookApi {
         });
         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

@@ -49,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;
 }
@@ -115,11 +117,13 @@ export interface PhoneNumberInfo {
 }
 export interface SendAudioParams {
     to: string;
-    link: string;
+    link?: string;
+    id?: string;
 }
 export interface SendVideoParams {
     to: string;
-    link: string;
+    link?: string;
+    id?: string;
     caption?: string;
 }
 export interface MediaInfoResponse {
@@ -135,3 +139,33 @@ export interface CreateTemplateParams {
     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.13",
+    "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",