meta-cloud-api 0.2.29 → 0.2.30

package/dist/chunk-TEJIY4ZS.js

@@ -0,0 +1,3 @@
+import {a as a$1,b}from'./chunk-HEVRZRB4.js';import {a}from'./chunk-VW3LGHTJ.js';import*as l from'crypto';import l__default from'crypto';var S=(t=>(t.DELIVERED="delivered",t.READ="read",t.SENT="sent",t))(S||{});function H(s){return typeof s=="object"&&s!==null}function f(s){return typeof s=="string"}var q=["data_exchange","INIT","BACK"],F=["data_exchange","INIT"];function W(s){if(!("flow_token"in s&&f(s.flow_token)&&"action"in s))return  false;let{action:e,version:o,screen:t,data:r}=s,a=o==="3.0",c=q.includes(e),g=typeof t>"u"||f(t)&&t!=="SUCCESS",p=e==="data_exchange"||H(r);return a&&c&&g&&p}function v(s){if(!("flow_token"in s&&f(s.flow_token)&&"action"in s))return  false;let{action:e,screen:o,data:t}=s,r=F.includes(e),a=f(o),c=H(t)&&"error_key"in t&&f(t.error)&&"error_message"in t&&f(t.error_message);return r&&a&&c}function T(s){return "action"in s&&s.action==="ping"}var I="WEBHOOK_UTILS",d=new a(I,process.env.DEBUG==="true");function w(s,e){let o=s.query["hub.mode"],t=s.query["hub.verify_token"],r=s.query["hub.challenge"];return o!==void 0&&t!==void 0&&r!==void 0?o==="subscribe"&&t===e?(d.log("Webhook verified successfully"),{statusCode:200,body:r}):(d.log("Webhook verification failed"),{statusCode:403}):(d.log("Not a webhook verification request - missing required parameters"),{statusCode:400,body:{error:"Invalid webhook verification request"}})}async function k(s,e,o){let t=s.body,r=[];if(t.object!=="whatsapp_business_account"){let a="Received webhook for non-WhatsApp event";return d.log(a),{statusCode:404,body:{error:a}}}for(let a of t.entry)try{let c=a.changes;for(let g of c)g.field==="messages"&&await P(a.id,g.value,e,o);}catch(c){let g=`Error processing webhook: ${c}`;d.log(g),r.push(g);}return {statusCode:200,body:r.length>0?{errors:r}:void 0}}async function E(s,e,o,t){try{if(!N(s,e.WEBHOOK_VERIFICATION_TOKEN||""))return d.log("Invalid request signature"),{statusCode:401,body:{error:"Unauthorized"}};let r=JSON.parse(s.rawBody||"{}"),{decryptedBody:a}=O(r,e),c=t.get("*");if(!c)return d.log(`No handler registered for flow action: ${a.action}`),{statusCode:404,body:{error:"Handler not found"}};if(T(a))return {statusCode:200,body:{version:"3.0",data:{status:"active"}}};if(v(a))return d.log(`Flow error: ${JSON.stringify(a)}`),{statusCode:200,body:{}};if(W(a)){let g=await c(o,a);return {statusCode:200,body:D(g,Buffer.from(r.aes_key,"base64"),Buffer.from(r.initial_vector,"base64"))}}return d.log(`Unknown flow request type: ${JSON.stringify(a)}`),{statusCode:400,body:{error:"Unknown request type"}}}catch(r){return d.log(`Error handling flow request: ${r}`),{statusCode:500,body:{error:"Internal server error"}}}}async function P(s,e,o,t){let r=e.metadata,a=e.contacts,c=s,g=r?.display_phone_number||"",p=r?.phone_number_id||"",y=a?.[0]?.profile?.name||"";if(e.statuses&&e.statuses.length>0){let m=e.statuses;for(let n of m){let u={wabaId:c,id:n.id,from:n.recipient_id,timestamp:n.timestamp,type:"statuses",phoneNumberId:p,displayPhoneNumber:g,profileName:y,statuses:e.statuses[0],originalData:n};await M(t.messageHandlers.get("statuses"),o,u,"statuses");}return}if(e.messages&&e.messages.length>0){let m=e.messages;for(let n of m){let u=n.type,i={wabaId:c,id:n.id,from:n.from,timestamp:n.timestamp,type:n.type,phoneNumberId:p,displayPhoneNumber:g,profileName:y,originalData:n};switch(u){case "text":i.text=n.text;break;case "image":i.image=n.image;break;case "video":i.video=n.video;break;case "audio":i.audio=n.audio;break;case "document":i.document=n.document;break;case "sticker":i.sticker=n.sticker;break;case "location":i.location=n.location;break;case "contacts":i.contacts=n.contacts;break;case "interactive":i.interactive=n.interactive;break;case "button":i.button=n.button;break;case "order":i.order=n.order;break;case "system":i.system=n.system;break;case "reaction":i.reaction=n.reaction;break;default:d.log(`Unknown message type: ${u}`);break}await M(t.preProcessHandler,o,i,"pre-process"),await M(t.messageHandlers.get(u),o,i,u),await M(t.postProcessHandler,o,i,"post-process");}}}async function M(s,e,o,t){if(s)try{await s(e,o);}catch(r){d.log(`Error in ${t} handler: ${r}`);}}function N(s,e){let o=s.headers["x-hub-signature-256"];if(!o||!s.rawBody)return  false;let r=`sha256=${l__default.createHmac("sha256",e).update(s.rawBody,"utf8").digest("hex")}`;return l__default.timingSafeEqual(Buffer.from(o),Buffer.from(r))}function O(s,e){let{encrypted_aes_key:o,encrypted_flow_data:t,initial_vector:r}=s;if(!o||!t||!r)throw new Error("Missing required encryption properties");let a=e.FLOW_API_PRIVATE_PEM.replace(/\\n/g,`
+`),c=e.FLOW_API_PASSPHRASE,g=l__default.createPrivateKey({key:a,passphrase:c}),p;try{p=l__default.privateDecrypt({key:g,padding:l__default.constants.RSA_PKCS1_OAEP_PADDING,oaepHash:"sha256"},Buffer.from(o,"base64"));}catch{throw new Error("Failed to decrypt the request. Please verify your private key.")}let y=Buffer.from(t,"base64"),m=Buffer.from(r,"base64"),u=y.subarray(0,-16),i=y.subarray(-16),_=l__default.createDecipheriv("aes-128-gcm",p,m);_.setAuthTag(i);let C=Buffer.concat([_.update(u),_.final()]).toString("utf-8");return {decryptedBody:JSON.parse(C),aesKeyBuffer:p,initialVectorBuffer:m}}function D(s,e,o){let t=[];for(let r of Array.from(o.entries()))t.push(~r[1]);try{let r=l__default.createCipheriv("aes-128-gcm",e,Buffer.from(t));return Buffer.concat([r.update(JSON.stringify(s||{}),"utf-8"),r.final(),r.getAuthTag()]).toString("base64")}catch(r){throw d.log("Response encryption error:",r),new Error("Failed to encrypt response. Internal server error.")}}var V="WEBHOOK",h=new a(V,process.env.DEBUG==="true"),R=class{config;client;messageHandlers=new Map;preProcessHandler=void 0;postProcessHandler=void 0;flowHandlers=new Map;constructor(e){this.config=a$1(e),this.client=new b(e),h.log("WebhookHandler instantiated!");}handleVerification=e=>w(e,this.config.WEBHOOK_VERIFICATION_TOKEN||"");handleWebhook=async e=>k(e,this.client,{messageHandlers:this.messageHandlers,preProcessHandler:this.preProcessHandler,postProcessHandler:this.postProcessHandler});handleFlow=async e=>E(e,this.config,this.client,this.flowHandlers);onMessage(e,o){this.messageHandlers.set(e,o),h.log(`Registered message handler for ${e}`);}onMessagePreProcess(e){this.preProcessHandler=e,h.log("Registered pre-process handler");}onMessagePostProcess(e){this.postProcessHandler=e,h.log("Registered post-process handler");}onFlow(e,o){this.flowHandlers.set(e,o),h.log(`Registered flow handler for ${e}`);}};var oe=(s,e)=>l.createHmac("sha256",e).update(s,"utf-8").digest("hex");export{S as a,w as b,k as c,E as d,R as e,oe as f};//# sourceMappingURL=chunk-TEJIY4ZS.js.map
+//# sourceMappingURL=chunk-TEJIY4ZS.js.map

package/dist/chunk-TEJIY4ZS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/webhook/types.ts","../src/shared/utils/flowTypeGuards.ts","../src/core/webhook/utils/webhookUtils.ts","../src/core/webhook/WebhookHandler.ts","../src/core/webhook/utils/generateXHub256Sig.ts"],"names":["MessageStatus","isObject","value","isString","DATA_EXCHANGE_ACTIONS","ERROR_ACTIONS","isFlowDataExchangeRequest","request","action","version","screen","data","hasValidVersion","hasValidAction","hasValidScreen","hasValidData","isFlowErrorRequest","isFlowPingRequest","LIB_NAME","LOGGER","Logger","verifyWebhook","verificationToken","mode","token","challenge","processWebhookMessages","whatsapp","handlers","body","errors","errorMsg","entry","changes","change","processMessages","error","processFlowRequest","config","flowHandlers","isRequestSignatureValid","decryptedBody","decryptFlowRequest","handler","result","encryptFlowResponse","waba_id","metadata","contacts","wabaId","displayPhoneNumber","phoneNumberId","profileName","statuses","status","processedStatus","executeHandler","messages","message","messageType","processedMessage","handlerType","signature","formattedExpectedSignature","crypto","encrypted_aes_key","encrypted_flow_data","initial_vector","privatePem","passphrase","privateKey","decryptedAesKey","flowDataBuffer","initialVectorBuffer","TAG_LENGTH","encrypted_flow_data_body","encrypted_flow_data_tag","decipher","decryptedJSONString","response","aesKeyBuffer","flipped_iv","pair","cipher","WebhookHandler","importConfig","WhatsApp","type","generateXHub256Sig","appSecret","B"],"mappings":"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","file":"chunk-TEJIY4ZS.js","sourcesContent":["import { MessageTypesEnum } from '@shared/types/enums';\n\nexport interface WebhookContact {\n    /**\n     * WhatsApp ID of the contact. Business can respond to this contact using this ID.\n     */\n    wa_id: string;\n    /**\n     *  Additional unique, alphanumeric identifier for a WhatsApp user\n     */\n    user_id?: string;\n    /**\n     * Profile of Whatsapp user\n     */\n    profile: {\n        /**\n         * The display name of the contact\n         */\n        name: string;\n    };\n}\n\n/**\n * Base message interface with common properties\n */\nexport interface BaseMessage {\n    id: string;\n    from: string;\n    timestamp: string;\n    type: MessageTypesEnum;\n    /**\n     * Context object, included when a user replies or interacts\n     */\n    context?: {\n        /**\n         * ID of the message\n         */\n        id?: string;\n        /**\n         * ID of the sender\n         */\n        from?: string;\n        /**\n         * ID of the message being replied to or interacted with\n         */\n        message_id: string;\n        /**\n         * ID of the forwarded message, if applicable\n         */\n        forwarded?: boolean;\n        /**\n         * Frequently forwarded status\n         */\n        frequently_forwarded?: boolean;\n        /**\n         * Original message information if the message was referred\n         */\n        referred_product?: {\n            /**\n             * Catalog ID\n             */\n            catalog_id: string;\n            /**\n             * Product ID\n             */\n            product_retailer_id: string;\n        };\n    };\n    /**\n     * Errors array, if the message had errors\n     */\n    errors?: Array<{\n        /**\n         * Error code\n         */\n        code: number;\n        /**\n         * Error title\n         */\n        title: string;\n        /**\n         * Error message\n         */\n        message: string;\n        /**\n         * Error details object\n         */\n        error_data?: {\n            /**\n             * Describes the error details\n             */\n            details: string;\n        };\n    }>;\n}\n\n/**\n * Text message interface\n */\nexport interface TextMessage extends BaseMessage {\n    type: MessageTypesEnum.Text;\n    text: {\n        /**\n         * The text content of the message\n         */\n        body: string;\n        preview_url?: boolean;\n    };\n}\n\n/**\n * Image message interface\n */\nexport interface ImageMessage extends BaseMessage {\n    type: MessageTypesEnum.Image;\n    image: {\n        /**\n         * The image caption (if provided)\n         */\n        caption?: string;\n        /**\n         * The SHA256 hash of the image\n         */\n        sha256?: string;\n        /**\n         * The ID for the image\n         */\n        id: string;\n        /**\n         * The MIME type of the image\n         */\n        mime_type: string;\n    };\n}\n\n/**\n * Video message interface\n */\nexport interface VideoMessage extends BaseMessage {\n    type: MessageTypesEnum.Video;\n    video: {\n        /**\n         * The video caption (if provided)\n         */\n        caption?: string;\n        /**\n         * The SHA256 hash of the video\n         */\n        sha256?: string;\n        /**\n         * The ID for the video\n         */\n        id: string;\n        /**\n         * The MIME type of the video\n         */\n        mime_type: string;\n    };\n}\n\n/**\n * Audio message interface\n */\nexport interface AudioMessage extends BaseMessage {\n    type: MessageTypesEnum.Audio;\n    audio: {\n        /**\n         * The ID for the audio file\n         */\n        id: string;\n        /**\n         * The MIME type of the audio file\n         */\n        mime_type: string;\n        /**\n         * Whether the audio is a voice message\n         */\n        voice?: boolean;\n    };\n}\n\n/**\n * Document message interface\n */\nexport interface DocumentMessage extends BaseMessage {\n    type: MessageTypesEnum.Document;\n    document: {\n        /**\n         * The document caption (if provided)\n         */\n        caption?: string;\n        /**\n         * The document filename\n         */\n        filename: string;\n        /**\n         * The SHA256 hash of the document\n         */\n        sha256?: string;\n        /**\n         * The ID for the document\n         */\n        id: string;\n        /**\n         * The MIME type of the document\n         */\n        mime_type: string;\n    };\n}\n\n/**\n * Sticker message interface\n */\nexport interface StickerMessage extends BaseMessage {\n    type: MessageTypesEnum.Sticker;\n    sticker: {\n        /**\n         * The ID for the sticker\n         */\n        id: string;\n        /**\n         * Whether this is an animated sticker\n         */\n        animated: boolean;\n        /**\n         * The MIME type of the sticker\n         */\n        mime_type: string;\n    };\n}\n\n/**\n * Reaction message interface\n */\nexport interface ReactionMessage extends BaseMessage {\n    type: MessageTypesEnum.Reaction;\n    reaction: {\n        /**\n         * The ID of the message being reacted to\n         */\n        message_id: string;\n        /**\n         * Emoji used for the reaction\n         */\n        emoji: string;\n    };\n}\n\n/**\n * Contacts message interface\n */\nexport interface ContactsMessage extends BaseMessage {\n    type: MessageTypesEnum.Contacts;\n    contacts: Array<{\n        /**\n         * The contact's name\n         */\n        name: {\n            /**\n             * The formatted name\n             */\n            formatted_name: string;\n            /**\n             * The first name\n             */\n            first_name?: string;\n            /**\n             * The last name\n             */\n            last_name?: string;\n            /**\n             * The middle name\n             */\n            middle_name?: string;\n            /**\n             * The suffix\n             */\n            suffix?: string;\n            /**\n             * The prefix\n             */\n            prefix?: string;\n        };\n        /**\n         * The contact's phone numbers\n         */\n        phones?: Array<{\n            phone: string;\n            type?: string;\n            wa_id?: string;\n        }>;\n        /**\n         * The contact's emails\n         */\n        emails?: Array<{\n            email: string;\n            type?: string;\n        }>;\n        /**\n         * The contact's addresses\n         */\n        addresses?: Array<{\n            street?: string;\n            city?: string;\n            state?: string;\n            zip?: string;\n            country?: string;\n            country_code?: string;\n            type?: string;\n        }>;\n        /**\n         * The contact's organizations\n         */\n        org?: {\n            company?: string;\n            department?: string;\n            title?: string;\n        };\n        /**\n         * The contact's URLs\n         */\n        urls?: Array<{\n            url: string;\n            type?: string;\n        }>;\n        /**\n         * The contact's birthday (YYYY-MM-DD format)\n         */\n        birthday?: string;\n    }>;\n}\n\n/**\n * Location message interface\n */\nexport interface LocationMessage extends BaseMessage {\n    type: MessageTypesEnum.Location;\n    location: {\n        /**\n         * Latitude of the location\n         */\n        latitude: number;\n        /**\n         * Longitude of the location\n         */\n        longitude: number;\n        /**\n         * Name of the location\n         */\n        name?: string;\n        /**\n         * Address of the location\n         */\n        address?: string;\n    };\n}\n\n/**\n * Interactive message interface\n */\nexport interface InteractiveMessage extends BaseMessage {\n    type: MessageTypesEnum.Interactive;\n    interactive: {\n        /**\n         * Type of the interactive message\n         * Can be: button_reply, list_reply, flow, nfm_reply, etc.\n         */\n        type: string;\n        /**\n         * ID for the button that was clicked\n         */\n        button_reply?: {\n            id: string;\n            title: string;\n        };\n        /**\n         * ID for the list item that was selected\n         */\n        list_reply?: {\n            id: string;\n            title: string;\n            description?: string;\n        };\n        /**\n         * NFM (No-Code Flow Message) reply data\n         */\n        nfm_reply?: {\n            /**\n             * Response data in JSON format\n             */\n            response_json: string;\n            /**\n             * Body text of the reply\n             */\n            body: string;\n            /**\n             * Name of the flow\n             */\n            name: string;\n        };\n    };\n}\n\n/**\n * System message interface\n */\nexport interface SystemMessage extends BaseMessage {\n    type: MessageTypesEnum.System;\n    system: {\n        /**\n         * The type of system update\n         */\n        type: string;\n        /**\n         * User's identity if the update is a customer identity change\n         */\n        identity?: string;\n        /**\n         * Old and new phone numbers if the update is a phone number change\n         */\n        customer?: {\n            /**\n             * The previous phone number\n             */\n            previous_wa_id: string;\n            /**\n             * The new phone number\n             */\n            wa_id: string;\n        };\n    };\n}\n\n/**\n * Order message interface\n */\nexport interface OrderMessage extends BaseMessage {\n    type: MessageTypesEnum.Order;\n    order: {\n        /**\n         * Catalog ID\n         */\n        catalog_id: string;\n        /**\n         * Product items in the order\n         */\n        product_items: Array<{\n            /**\n             * Product ID\n             */\n            product_retailer_id: string;\n            /**\n             * Quantity of the product\n             */\n            quantity: number;\n            /**\n             * Item price\n             */\n            item_price: number;\n            /**\n             * Currency code\n             */\n            currency: string;\n        }>;\n        /**\n         * Text message included with the order\n         */\n        text?: string;\n    };\n}\n\n/**\n * Button message interface\n */\nexport interface ButtonMessage extends BaseMessage {\n    type: MessageTypesEnum.Button;\n    button: {\n        /**\n         * The payload for the button\n         */\n        payload: string;\n        /**\n         * Button text\n         */\n        text: string;\n    };\n}\n\n/**\n * Union type for all message types\n */\nexport type WhatsAppMessage =\n    | TextMessage\n    | ImageMessage\n    | VideoMessage\n    | AudioMessage\n    | DocumentMessage\n    | StickerMessage\n    | ReactionMessage\n    | ContactsMessage\n    | LocationMessage\n    | InteractiveMessage\n    | SystemMessage\n    | OrderMessage\n    | ButtonMessage;\n\nexport interface WebhookMessageValue {\n    /**\n     * The messaging product\n     */\n    messaging_product: string;\n    /**\n     * The metadata\n     */\n    metadata: {\n        /**\n         * The display phone number of the whatsapp business account\n         */\n        display_phone_number: string;\n        /**\n         * The phone number ID of the whatsapp business account\n         */\n        phone_number_id: string;\n    };\n    contacts?: Array<{\n        profile: {\n            /**\n             * The display name of the whatsapp user\n             */\n            name: string;\n        };\n        /**\n         * The whatsapp ID of the user\n         */\n        wa_id: string;\n    }>;\n    messages: Array<WhatsAppMessage>;\n\n    statuses?: Array<{\n        /**\n         * The ID of the message\n         */\n        id: string;\n        /**\n         * The status of the message\n         */\n        status: MessageStatus;\n        /**\n         * The timestamp of the message\n         */\n        timestamp: string;\n        /**\n         * The recipient ID ( phone number of the user )\n         */\n        recipient_id: string;\n    }>;\n\n    errors?: Array<{\n        /**\n         * The error code\n         */\n        code: number;\n        /**\n         * The error title\n         */\n        title: string;\n        /**\n         * The error data\n         */\n        error_data?: {\n            /**\n             * The error details\n             */\n            details: string;\n        };\n    }>;\n}\n\n/**\n * Represents a message received through the webhook\n * Based on Meta's documentation: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components#messages-object\n */\nexport interface WebhookMessage {\n    /**\n     * The WhatsApp Business Account ID\n     */\n    wabaId: string;\n\n    /**\n     * The message ID\n     */\n    id: string;\n\n    /**\n     * The sender's phone number\n     */\n    from: string;\n\n    /**\n     * The timestamp of the message\n     */\n    timestamp: string;\n\n    /**\n     * The type of message (text, image, etc.)\n     */\n    type: MessageTypesEnum;\n\n    /**\n     * The phone number ID that received the message\n     */\n    phoneNumberId: string;\n\n    /**\n     * The display phone number that received the message\n     */\n    displayPhoneNumber: string;\n\n    /**\n     * The profile name of the sender\n     */\n    profileName: string;\n\n    text?: TextMessage['text'];\n    image?: ImageMessage['image'];\n    video?: VideoMessage['video'];\n    audio?: AudioMessage['audio'];\n    document?: DocumentMessage['document'];\n    sticker?: StickerMessage['sticker'];\n    location?: LocationMessage['location'];\n    contacts?: ContactsMessage['contacts'];\n    interactive?: InteractiveMessage['interactive'];\n    button?: ButtonMessage['button'];\n    order?: OrderMessage['order'];\n    system?: SystemMessage['system'];\n    reaction?: ReactionMessage['reaction'];\n\n    statuses?: {\n        /**\n         * Arbitrary string included in sent message\n         */\n        biz_opaque_callback_data?: string;\n\n        /**\n         * Information about the conversation\n         */\n        conversation?: {\n            /**\n             * Represents the ID of the conversation the given status notification belongs to\n             */\n            id: string;\n            /**\n             * Describes conversation category\n             */\n            origin: {\n                /**\n                 * Indicates conversation category. This can also be referred to as a conversation entry point\n                 * - authentication: Conversation opened by business sending template categorized as AUTHENTICATION\n                 * - marketing: Conversation opened by business sending template categorized as MARKETING\n                 * - utility: Conversation opened by business sending template categorized as UTILITY\n                 * - service: Conversation opened by business replying to customer within service window\n                 * - referral_conversion: Free entry point conversation\n                 */\n                type: 'authentication' | 'marketing' | 'utility' | 'service' | 'referral_conversion';\n            };\n            /**\n             * Date when the conversation expires. Only present for messages with status 'sent'\n             */\n            expiration_timestamp?: string;\n        };\n\n        /**\n         * Array of error objects describing the error\n         */\n        errors?: Array<{\n            /**\n             * Error code\n             */\n            code: number;\n            /**\n             * Error code title\n             */\n            title: string;\n            /**\n             * Error code message\n             */\n            message: string;\n            /**\n             * Error details object\n             */\n            error_data?: {\n                /**\n                 * Describes the error details\n                 */\n                details: string;\n            };\n        }>;\n\n        /**\n         * The ID for the message that the business sent to a customer\n         */\n        id: string;\n\n        /**\n         * Pricing information for the message/conversation\n         */\n        pricing?: {\n            /**\n             * Indicates if the given message or conversation is billable\n             * @deprecated This field is deprecated. Visit the WhatsApp Changelog for more information.\n             */\n            billable?: boolean;\n            /**\n             * Indicates the conversation category:\n             * - authentication: Authentication conversation\n             * - authentication_international: Authentication-international conversation\n             * - marketing: Marketing conversation\n             * - utility: Utility conversation\n             * - service: Service conversation\n             * - referral_conversion: Free entry point conversation\n             */\n            category:\n                | 'authentication'\n                | 'authentication_international'\n                | 'marketing'\n                | 'utility'\n                | 'service'\n                | 'referral_conversion';\n            /**\n             * Type of pricing model used by the business. Current supported value is CBP\n             */\n            pricing_model: 'CBP';\n        };\n\n        /**\n         * The customer's WhatsApp ID. Business can respond to customer using this ID.\n         * This ID may not match the customer's phone number.\n         */\n        recipient_id: string;\n\n        /**\n         * Status of the message:\n         * - delivered: Message has been delivered\n         * - read: Message has been read by the customer\n         * - sent: Message has been sent to the customer\n         */\n        status: 'delivered' | 'read' | 'sent';\n\n        /**\n         * Unix timestamp for the status message\n         */\n        timestamp: string;\n    };\n    /**\n     * The original message data as received from the webhook\n     */\n    originalData: any;\n}\n\n/**\n * Webhook event received from WhatsApp\n */\nexport interface WebhookEvent {\n    /**\n     * The field type of the event\n     */\n    field: string;\n\n    /**\n     * The event data\n     */\n    value: any;\n\n    /**\n     * The timestamp when the event was received\n     */\n    timestamp: number;\n}\n\n/**\n * Message handler function type\n */\nexport type MessageHandler = (message: WebhookMessage) => void | Promise<void>;\n\n/**\n * Message status enum\n */\nexport enum MessageStatus {\n    DELIVERED = 'delivered',\n    READ = 'read',\n    SENT = 'sent',\n}\n","import {\n    FlowActionEnum,\n    FlowDataExchangeRequest,\n    FlowEndpointRequest,\n    FlowErrorNotificationRequest,\n    FlowHealthCheckRequest,\n} from '@features/flow/types';\n\n/**\n * Helper function to check if a value is an object\n * @param value The value to check\n * @returns True if the value is a non-null object\n */\nfunction isObject(value: unknown): value is Record<string, unknown> {\n    return typeof value === 'object' && value !== null;\n}\n\n/**\n * Helper function to check if a value is a string\n * @param value The value to check\n * @returns True if the value is a string\n */\nfunction isString(value: unknown): value is string {\n    return typeof value === 'string';\n}\n\n// Array of allowed action types for data exchange requests\nconst DATA_EXCHANGE_ACTIONS = [FlowActionEnum.DATA_EXCHANGE, FlowActionEnum.INIT, FlowActionEnum.BACK] as const;\n\n// Array of allowed action types for error notification requests\nconst ERROR_ACTIONS = [FlowActionEnum.DATA_EXCHANGE, FlowActionEnum.INIT] as const;\n\n/**\n * Type guard to check if a request is a Data Exchange request\n * Validates the request structure according to the Flow API specifications\n *\n * @param request The Flow endpoint request to check\n * @returns True if the request is a valid Data Exchange request, false otherwise\n */\nexport function isFlowDataExchangeRequest(request: FlowEndpointRequest): request is FlowDataExchangeRequest & {\n    action: (typeof DATA_EXCHANGE_ACTIONS)[number];\n    screen?: string;\n    flow_token: string;\n    data?: Record<string, any>;\n} {\n    // Check for basic required fields\n    if (!('flow_token' in request && isString(request.flow_token) && 'action' in request)) {\n        return false;\n    }\n\n    const { action, version, screen, data } = request;\n\n    // Validate API version\n    const hasValidVersion = version === '3.0';\n\n    // Check if the action is one of the allowed actions for data exchange\n    const hasValidAction = DATA_EXCHANGE_ACTIONS.includes(action as any);\n\n    // Screen is optional, but when present must be a string and not 'SUCCESS'\n    const hasValidScreen = typeof screen === 'undefined' || (isString(screen) && screen !== 'SUCCESS');\n\n    // Data is required except for DATA_EXCHANGE action\n    const hasValidData = action === FlowActionEnum.DATA_EXCHANGE || isObject(data);\n\n    // All conditions must be met for a valid data exchange request\n    return hasValidVersion && hasValidAction && hasValidScreen && hasValidData;\n}\n\n/**\n * Type guard to check if a request is an Error Notification request\n * Validates the request structure according to the Flow API error specifications\n *\n * @param request The Flow endpoint request to check\n * @returns True if the request is a valid Error Notification request, false otherwise\n */\nexport function isFlowErrorRequest(request: FlowEndpointRequest): request is FlowErrorNotificationRequest & {\n    action: (typeof ERROR_ACTIONS)[number];\n    screen: string;\n    flow_token: string;\n    data: {\n        error: string;\n        error_message: string;\n    };\n} {\n    // Check for basic required fields\n    if (!('flow_token' in request && isString(request.flow_token) && 'action' in request)) {\n        return false;\n    }\n\n    const { action, screen, data } = request;\n\n    // Check if the action is one of the allowed actions for error notifications\n    const hasValidAction = ERROR_ACTIONS.includes(action as any);\n\n    // Screen is required for error notifications\n    const hasValidScreen = isString(screen);\n\n    // Validate error data structure\n    const hasValidData =\n        isObject(data) &&\n        'error_key' in data &&\n        isString(data.error) &&\n        'error_message' in data &&\n        isString(data.error_message);\n\n    // All conditions must be met for a valid error notification request\n    return hasValidAction && hasValidScreen && hasValidData;\n}\n\n/**\n * Type guard to check if a request is a Ping (health check) request\n * Simple validation for health check endpoints in the Flow API\n *\n * @param request The Flow endpoint request to check\n * @returns True if the request is a Ping request, false otherwise\n */\nexport function isFlowPingRequest(request: FlowEndpointRequest): request is FlowHealthCheckRequest {\n    // A ping request only requires the 'action' field with value 'ping'\n    return 'action' in request && request.action === 'ping';\n}\n","import { FlowEndpointRequest } from '@features/flow';\nimport { FlowTypeEnum } from '@features/flow/types';\nimport { MessageTypesEnum } from '@shared/types';\nimport { WabaConfigType } from '@shared/types/config';\nimport { isFlowDataExchangeRequest, isFlowErrorRequest, isFlowPingRequest } from '@shared/utils/flowTypeGuards';\nimport Logger from '@shared/utils/logger';\nimport crypto from 'crypto';\nimport { WhatsApp } from '../../whatsapp';\nimport { WebhookMessage, WebhookMessageValue } from '../types';\n\nconst LIB_NAME = 'WEBHOOK_UTILS';\nconst LOGGER = new Logger(LIB_NAME, process.env.DEBUG === 'true');\n\nexport interface WebhookRequest {\n    method: string;\n    query: Record<string, any>;\n    body: any;\n    headers: Record<string, string | string[] | undefined>;\n    rawBody?: string;\n}\n\nexport interface WebhookResponse {\n    statusCode: number;\n    body?: any;\n    headers?: Record<string, string>;\n}\n\nexport type MessageHandler = (whatsapp: WhatsApp, message: WebhookMessage) => void | Promise<void>;\nexport type FlowHandler = (whatsapp: WhatsApp, request: FlowEndpointRequest) => any | Promise<any>;\n\n/**\n * Pure function to handle webhook verification\n */\nexport function verifyWebhook(request: Pick<WebhookRequest, 'query'>, verificationToken: string): WebhookResponse {\n    const mode = request.query['hub.mode'];\n    const token = request.query['hub.verify_token'];\n    const challenge = request.query['hub.challenge'];\n\n    // Check if this is actually a webhook verification request\n    const isWebhookVerificationRequest = mode !== undefined && token !== undefined && challenge !== undefined;\n\n    if (!isWebhookVerificationRequest) {\n        LOGGER.log('Not a webhook verification request - missing required parameters');\n        return {\n            statusCode: 400,\n            body: { error: 'Invalid webhook verification request' },\n        };\n    }\n\n    const VERIFICATION_SUCCESS = mode === 'subscribe' && token === verificationToken;\n\n    if (VERIFICATION_SUCCESS) {\n        LOGGER.log('Webhook verified successfully');\n        return {\n            statusCode: 200,\n            body: challenge,\n        };\n    } else {\n        LOGGER.log('Webhook verification failed');\n        return {\n            statusCode: 403,\n        };\n    }\n}\n\n/**\n * Pure function to process webhook messages\n */\nexport async function processWebhookMessages(\n    request: WebhookRequest,\n    whatsapp: WhatsApp,\n    handlers: {\n        messageHandlers: Map<MessageTypesEnum, MessageHandler>;\n        preProcessHandler?: MessageHandler;\n        postProcessHandler?: MessageHandler;\n    },\n): Promise<WebhookResponse> {\n    const body = request.body;\n    const errors: string[] = [];\n\n    // Check this is a WhatsApp Business Account webhook\n    if (body.object !== 'whatsapp_business_account') {\n        const errorMsg = 'Received webhook for non-WhatsApp event';\n        LOGGER.log(errorMsg);\n        return {\n            statusCode: 404,\n            body: { error: errorMsg },\n        };\n    }\n\n    // Process each entry\n    for (const entry of body.entry) {\n        try {\n            const changes = entry.changes;\n            for (const change of changes) {\n                if (change.field === 'messages') {\n                    await processMessages(entry.id, change.value, whatsapp, handlers);\n                }\n            }\n        } catch (error) {\n            const errorMsg = `Error processing webhook: ${error}`;\n            LOGGER.log(errorMsg);\n            errors.push(errorMsg);\n        }\n    }\n\n    return {\n        statusCode: 200,\n        body: errors.length > 0 ? { errors } : undefined,\n    };\n}\n\n/**\n * Pure function to handle flow requests\n */\nexport async function processFlowRequest(\n    request: WebhookRequest,\n    config: WabaConfigType,\n    whatsapp: WhatsApp,\n    flowHandlers: Map<FlowTypeEnum, FlowHandler>,\n): Promise<WebhookResponse> {\n    try {\n        // Validate request signature\n        if (!isRequestSignatureValid(request, config.WEBHOOK_VERIFICATION_TOKEN || '')) {\n            LOGGER.log('Invalid request signature');\n            return {\n                statusCode: 401,\n                body: { error: 'Unauthorized' },\n            };\n        }\n\n        const body = JSON.parse(request.rawBody || '{}');\n\n        // Decrypt the request\n        const { decryptedBody } = decryptFlowRequest(body, config);\n\n        // Get the flow handler\n        const handler = flowHandlers.get(FlowTypeEnum.All);\n        if (!handler) {\n            LOGGER.log(`No handler registered for flow action: ${decryptedBody.action}`);\n            return {\n                statusCode: 404,\n                body: { error: 'Handler not found' },\n            };\n        }\n\n        // Handle different flow types\n        if (isFlowPingRequest(decryptedBody)) {\n            return {\n                statusCode: 200,\n                body: {\n                    version: '3.0',\n                    data: { status: 'active' },\n                },\n            };\n        }\n\n        if (isFlowErrorRequest(decryptedBody)) {\n            LOGGER.log(`Flow error: ${JSON.stringify(decryptedBody)}`);\n            return {\n                statusCode: 200,\n                body: {},\n            };\n        }\n\n        if (isFlowDataExchangeRequest(decryptedBody)) {\n            const result = await handler(whatsapp, decryptedBody);\n            const encryptedResponse = encryptFlowResponse(\n                result,\n                Buffer.from(body.aes_key, 'base64'),\n                Buffer.from(body.initial_vector, 'base64'),\n            );\n\n            return {\n                statusCode: 200,\n                body: encryptedResponse,\n            };\n        }\n\n        LOGGER.log(`Unknown flow request type: ${JSON.stringify(decryptedBody)}`);\n        return {\n            statusCode: 400,\n            body: { error: 'Unknown request type' },\n        };\n    } catch (error) {\n        LOGGER.log(`Error handling flow request: ${error}`);\n        return {\n            statusCode: 500,\n            body: { error: 'Internal server error' },\n        };\n    }\n}\n\n/**\n * Private helper functions\n */\nasync function processMessages(\n    waba_id: string,\n    value: WebhookMessageValue,\n    whatsapp: WhatsApp,\n    handlers: {\n        messageHandlers: Map<MessageTypesEnum, MessageHandler>;\n        preProcessHandler?: MessageHandler;\n        postProcessHandler?: MessageHandler;\n    },\n): Promise<void> {\n    const metadata = value.metadata;\n    const contacts = value.contacts;\n    const wabaId = waba_id;\n    const displayPhoneNumber = metadata?.display_phone_number || '';\n    const phoneNumberId = metadata?.phone_number_id || '';\n    const profileName = contacts?.[0]?.profile?.name || '';\n\n    if (value.statuses && value.statuses.length > 0) {\n        const statuses = value.statuses;\n        for (const status of statuses) {\n            const processedStatus: WebhookMessage = {\n                wabaId,\n                id: status.id,\n                from: status.recipient_id,\n                timestamp: status.timestamp,\n                type: MessageTypesEnum.Statuses,\n                phoneNumberId,\n                displayPhoneNumber,\n                profileName,\n                statuses: value.statuses[0],\n                originalData: status,\n            };\n\n            await executeHandler(\n                handlers.messageHandlers.get(MessageTypesEnum.Statuses),\n                whatsapp,\n                processedStatus,\n                MessageTypesEnum.Statuses,\n            );\n        }\n        return;\n    }\n\n    if (value.messages && value.messages.length > 0) {\n        const messages = value.messages;\n\n        for (const message of messages) {\n            const messageType = message.type;\n\n            const processedMessage: WebhookMessage = {\n                wabaId,\n                id: message.id,\n                from: message.from,\n                timestamp: message.timestamp,\n                type: message.type,\n                phoneNumberId,\n                displayPhoneNumber,\n                profileName,\n                originalData: message,\n            };\n\n            switch (messageType) {\n                case MessageTypesEnum.Text:\n                    processedMessage.text = message.text;\n                    break;\n                case MessageTypesEnum.Image:\n                    processedMessage.image = message.image;\n                    break;\n                case MessageTypesEnum.Video:\n                    processedMessage.video = message.video;\n                    break;\n                case MessageTypesEnum.Audio:\n                    processedMessage.audio = message.audio;\n                    break;\n                case MessageTypesEnum.Document:\n                    processedMessage.document = message.document;\n                    break;\n                case MessageTypesEnum.Sticker:\n                    processedMessage.sticker = message.sticker;\n                    break;\n                case MessageTypesEnum.Location:\n                    processedMessage.location = message.location;\n                    break;\n                case MessageTypesEnum.Contacts:\n                    processedMessage.contacts = message.contacts;\n                    break;\n                case MessageTypesEnum.Interactive:\n                    processedMessage.interactive = message.interactive;\n                    break;\n                case MessageTypesEnum.Button:\n                    processedMessage.button = message.button;\n                    break;\n                case MessageTypesEnum.Order:\n                    processedMessage.order = message.order;\n                    break;\n                case MessageTypesEnum.System:\n                    processedMessage.system = message.system;\n                    break;\n                case MessageTypesEnum.Reaction:\n                    processedMessage.reaction = message.reaction;\n                    break;\n                default:\n                    LOGGER.log(`Unknown message type: ${messageType}`);\n                    break;\n            }\n\n            // Execute handlers in sequence\n            await executeHandler(handlers.preProcessHandler, whatsapp, processedMessage, 'pre-process');\n            await executeHandler(handlers.messageHandlers.get(messageType), whatsapp, processedMessage, messageType);\n            await executeHandler(handlers.postProcessHandler, whatsapp, processedMessage, 'post-process');\n        }\n    }\n}\n\nasync function executeHandler(\n    handler: MessageHandler | undefined,\n    whatsapp: WhatsApp,\n    message: WebhookMessage,\n    handlerType: string,\n): Promise<void> {\n    if (handler) {\n        try {\n            await handler(whatsapp, message);\n        } catch (error) {\n            LOGGER.log(`Error in ${handlerType} handler: ${error}`);\n        }\n    }\n}\n\nfunction isRequestSignatureValid(request: WebhookRequest, verificationToken: string): boolean {\n    const signature = request.headers['x-hub-signature-256'] as string;\n    if (!signature || !request.rawBody) {\n        return false;\n    }\n\n    const expectedSignature = crypto\n        .createHmac('sha256', verificationToken)\n        .update(request.rawBody, 'utf8')\n        .digest('hex');\n\n    const formattedExpectedSignature = `sha256=${expectedSignature}`;\n\n    return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(formattedExpectedSignature));\n}\n\nfunction decryptFlowRequest(\n    body: any,\n    config: WabaConfigType,\n): {\n    decryptedBody: FlowEndpointRequest;\n    aesKeyBuffer: Buffer;\n    initialVectorBuffer: Buffer;\n} {\n    const { encrypted_aes_key, encrypted_flow_data, initial_vector } = body;\n\n    if (!encrypted_aes_key || !encrypted_flow_data || !initial_vector) {\n        throw new Error('Missing required encryption properties');\n    }\n\n    const privatePem = config.FLOW_API_PRIVATE_PEM.replace(/\\\\n/g, '\\n');\n    const passphrase = config.FLOW_API_PASSPHRASE;\n\n    const privateKey = crypto.createPrivateKey({ key: privatePem, passphrase });\n    let decryptedAesKey: Buffer;\n\n    try {\n        decryptedAesKey = crypto.privateDecrypt(\n            {\n                key: privateKey,\n                padding: crypto.constants.RSA_PKCS1_OAEP_PADDING,\n                oaepHash: 'sha256',\n            },\n            Buffer.from(encrypted_aes_key, 'base64'),\n        );\n    } catch (error) {\n        throw new Error('Failed to decrypt the request. Please verify your private key.');\n    }\n\n    const flowDataBuffer = Buffer.from(encrypted_flow_data, 'base64');\n    const initialVectorBuffer = Buffer.from(initial_vector, 'base64');\n\n    const TAG_LENGTH = 16;\n    const encrypted_flow_data_body = flowDataBuffer.subarray(0, -TAG_LENGTH);\n    const encrypted_flow_data_tag = flowDataBuffer.subarray(-TAG_LENGTH);\n\n    const decipher = crypto.createDecipheriv('aes-128-gcm', decryptedAesKey, initialVectorBuffer);\n    decipher.setAuthTag(encrypted_flow_data_tag);\n\n    const decryptedJSONString = Buffer.concat([decipher.update(encrypted_flow_data_body), decipher.final()]).toString(\n        'utf-8',\n    );\n\n    return {\n        decryptedBody: JSON.parse(decryptedJSONString),\n        aesKeyBuffer: decryptedAesKey,\n        initialVectorBuffer,\n    };\n}\n\nfunction encryptFlowResponse(response: any, aesKeyBuffer: Buffer, initialVectorBuffer: Buffer): string {\n    const flipped_iv: number[] = [];\n    for (const pair of Array.from(initialVectorBuffer.entries())) {\n        flipped_iv.push(~pair[1]);\n    }\n\n    try {\n        const cipher = crypto.createCipheriv('aes-128-gcm', aesKeyBuffer, Buffer.from(flipped_iv));\n        return Buffer.concat([\n            cipher.update(JSON.stringify(response || {}), 'utf-8'),\n            cipher.final(),\n            cipher.getAuthTag(),\n        ]).toString('base64');\n    } catch (error) {\n        LOGGER.log('Response encryption error:', error);\n        throw new Error('Failed to encrypt response. Internal server error.');\n    }\n}\n","import { FlowTypeEnum } from '@features/flow/types';\nimport { importConfig } from '@shared/config/importConfig';\nimport { MessageTypesEnum } from '@shared/types';\nimport { WabaConfigType, WhatsAppConfig } from '@shared/types/config';\nimport Logger from '@shared/utils/logger';\nimport { WhatsApp } from '../whatsapp';\nimport {\n    FlowHandler,\n    MessageHandler,\n    processFlowRequest,\n    processWebhookMessages,\n    verifyWebhook,\n    WebhookRequest,\n    WebhookResponse,\n} from './utils/webhookUtils';\n\nconst LIB_NAME = 'WEBHOOK';\nconst LOGGER = new Logger(LIB_NAME, process.env.DEBUG === 'true');\n\n/**\n * Framework-agnostic WebhookHandler using pure functions\n */\nexport class WebhookHandler {\n    private config: WabaConfigType;\n    private client: WhatsApp;\n    private messageHandlers: Map<MessageTypesEnum, MessageHandler> = new Map();\n    private preProcessHandler: MessageHandler | undefined = undefined;\n    private postProcessHandler: MessageHandler | undefined = undefined;\n    private flowHandlers: Map<FlowTypeEnum, FlowHandler> = new Map();\n\n    constructor(config: WhatsAppConfig) {\n        this.config = importConfig(config);\n        this.client = new WhatsApp(config);\n        LOGGER.log('WebhookHandler instantiated!');\n    }\n\n    /**\n     * Handle webhook verification (framework-agnostic)\n     */\n    public handleVerification = (request: Pick<WebhookRequest, 'query'>): WebhookResponse => {\n        return verifyWebhook(request, this.config.WEBHOOK_VERIFICATION_TOKEN || '');\n    };\n\n    /**\n     * Handle webhook messages (framework-agnostic)\n     */\n    public handleWebhook = async (request: WebhookRequest): Promise<WebhookResponse> => {\n        return processWebhookMessages(request, this.client, {\n            messageHandlers: this.messageHandlers,\n            preProcessHandler: this.preProcessHandler,\n            postProcessHandler: this.postProcessHandler,\n        });\n    };\n\n    /**\n     * Handle flow requests (framework-agnostic)\n     */\n    public handleFlow = async (request: WebhookRequest): Promise<WebhookResponse> => {\n        return processFlowRequest(request, this.config, this.client, this.flowHandlers);\n    };\n\n    /**\n     * Register a message handler for a specific message type\n     */\n    public onMessage(type: MessageTypesEnum, handler: MessageHandler): void {\n        this.messageHandlers.set(type, handler);\n        LOGGER.log(`Registered message handler for ${type}`);\n    }\n\n    /**\n     * Register a pre-process handler that runs before all message handlers\n     */\n    public onMessagePreProcess(handler: MessageHandler): void {\n        this.preProcessHandler = handler;\n        LOGGER.log('Registered pre-process handler');\n    }\n\n    /**\n     * Register a post-process handler that runs after all message handlers\n     */\n    public onMessagePostProcess(handler: MessageHandler): void {\n        this.postProcessHandler = handler;\n        LOGGER.log('Registered post-process handler');\n    }\n\n    /**\n     * Register a flow handler for a specific flow type\n     */\n    public onFlow(type: FlowTypeEnum, handler: FlowHandler): void {\n        this.flowHandlers.set(type, handler);\n        LOGGER.log(`Registered flow handler for ${type}`);\n    }\n}\n","import * as crypto from 'crypto';\n\nexport const generateXHub256Sig = (body: string, appSecret: string) => {\n    return crypto.createHmac('sha256', appSecret).update(body, 'utf-8').digest('hex');\n};\n"]}

package/dist/core/webhook/index.d.ts

@@ -520,25 +520,7 @@ interface WebhookMessageValue {
          */
         wa_id: string;
     }>;
-    messages: Array<{
-        from: string;
-        id: string;
-        timestamp: string;
-        type: MessageTypesEnum;
-        text?: TextMessage;
-        image?: ImageMessage;
-        video?: VideoMessage;
-        audio?: AudioMessage;
-        document?: DocumentMessage;
-        sticker?: StickerMessage;
-        location?: LocationMessage;
-        contacts?: ContactsMessage;
-        interactive?: InteractiveMessage;
-        button?: ButtonMessage;
-        order?: OrderMessage;
-        system?: SystemMessage;
-        reaction?: ReactionMessage;
-    }>;
+    messages: Array<WhatsAppMessage>;
     statuses?: Array<{
         /**
          * The ID of the message
@@ -614,18 +596,19 @@ interface WebhookMessage {
      * The profile name of the sender
      */
     profileName: string;
-    text?: TextMessage;
-    image?: ImageMessage;
-    video?: VideoMessage;
-    audio?: AudioMessage;
-    document?: DocumentMessage;
-    sticker?: StickerMessage;
-    location?: LocationMessage;
-    contacts?: ContactsMessage;
-    interactive?: InteractiveMessage;
-    button?: ButtonMessage;
-    order?: OrderMessage;
-    system?: SystemMessage;
+    text?: TextMessage['text'];
+    image?: ImageMessage['image'];
+    video?: VideoMessage['video'];
+    audio?: AudioMessage['audio'];
+    document?: DocumentMessage['document'];
+    sticker?: StickerMessage['sticker'];
+    location?: LocationMessage['location'];
+    contacts?: ContactsMessage['contacts'];
+    interactive?: InteractiveMessage['interactive'];
+    button?: ButtonMessage['button'];
+    order?: OrderMessage['order'];
+    system?: SystemMessage['system'];
+    reaction?: ReactionMessage['reaction'];
     statuses?: {
         /**
          * Arbitrary string included in sent message

package/dist/core/webhook/index.js

@@ -1,2 +1,2 @@
-export{a as MessageStatus,e as WebhookHandler,f as generateXHub256Sig,d as processFlowRequest,c as processWebhookMessages,b as verifyWebhook}from'../../chunk-NTQYJXAZ.js';import'../../chunk-HEVRZRB4.js';import'../../chunk-3MO3BTBC.js';import'../../chunk-R36L2XYO.js';import'../../chunk-GT3XQN7Y.js';import'../../chunk-O2OTHNWM.js';import'../../chunk-7NQLQPLH.js';import'../../chunk-UQPD6GIF.js';import'../../chunk-5JGM556C.js';import'../../chunk-2NJVBJUN.js';import'../../chunk-XPPDOFBN.js';import'../../chunk-KFPOVYEJ.js';import'../../chunk-7GL74SXM.js';import'../../chunk-A264MT4Q.js';import'../../chunk-GIQLIMOD.js';import'../../chunk-BZ5QDXNR.js';import'../../chunk-VW3LGHTJ.js';import'../../chunk-SMHCU5MN.js';import'../../chunk-4C666HHU.js';//# sourceMappingURL=index.js.map
+export{a as MessageStatus,e as WebhookHandler,f as generateXHub256Sig,d as processFlowRequest,c as processWebhookMessages,b as verifyWebhook}from'../../chunk-TEJIY4ZS.js';import'../../chunk-HEVRZRB4.js';import'../../chunk-3MO3BTBC.js';import'../../chunk-R36L2XYO.js';import'../../chunk-GT3XQN7Y.js';import'../../chunk-O2OTHNWM.js';import'../../chunk-7NQLQPLH.js';import'../../chunk-UQPD6GIF.js';import'../../chunk-5JGM556C.js';import'../../chunk-2NJVBJUN.js';import'../../chunk-XPPDOFBN.js';import'../../chunk-KFPOVYEJ.js';import'../../chunk-7GL74SXM.js';import'../../chunk-A264MT4Q.js';import'../../chunk-GIQLIMOD.js';import'../../chunk-BZ5QDXNR.js';import'../../chunk-VW3LGHTJ.js';import'../../chunk-SMHCU5MN.js';import'../../chunk-4C666HHU.js';//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js

@@ -1,2 +1,2 @@
-export{a as TemplateApi}from'./chunk-H55VIWDI.js';export{a as QrCodeApi}from'./chunk-I222VSWK.js';import'./chunk-W2U7MN7M.js';export{a as MessageStatus,e as WebhookHandler,f as generateXHub256Sig,d as processFlowRequest,c as processWebhookMessages,b as verifyWebhook}from'./chunk-NTQYJXAZ.js';import {b}from'./chunk-HEVRZRB4.js';import'./chunk-3MO3BTBC.js';import'./chunk-R36L2XYO.js';import'./chunk-GT3XQN7Y.js';export{b as RegistrationApi}from'./chunk-O2OTHNWM.js';export{b as EncryptionApi}from'./chunk-7NQLQPLH.js';export{b as TwoStepVerificationApi}from'./chunk-UQPD6GIF.js';export{b as WabaApi}from'./chunk-5JGM556C.js';export{b as MessagesApi}from'./chunk-2NJVBJUN.js';import'./chunk-XPPDOFBN.js';export{b as BusinessProfileApi}from'./chunk-KFPOVYEJ.js';import'./chunk-7GL74SXM.js';export{b as FlowApi}from'./chunk-A264MT4Q.js';export{b as PhoneNumberApi}from'./chunk-GIQLIMOD.js';import'./chunk-BZ5QDXNR.js';import'./chunk-VW3LGHTJ.js';export{q as AudioMediaTypesEnum,y as BusinessVerticalEnum,h as ButtonPositionEnum,g as ButtonTypesEnum,a as CategoryEnum,i as ComponentTypesEnum,k as ConversationTypesEnum,w as CurrencyCodesEnum,x as DataLocalizationRegionEnum,p as DocumentMediaTypesEnum,c as HttpMethodsEnum,o as ImageMediaTypesEnum,f as InteractiveTypesEnum,v as LanguagesEnum,d as MessageTypesEnum,e as ParametersTypesEnum,t as ReferralSourceTypesEnum,u as RequestCodeMethodsEnum,l as StatusEnum,n as StickerMediaTypesEnum,s as SystemChangeTypesEnum,b as TemplateStatusEnum,m as VideoMediaTypesEnum,j as WabaConfigEnum,r as WebhookTypesEnum}from'./chunk-SMHCU5MN.js';import'./chunk-4C666HHU.js';var se=b;export{se as default};//# sourceMappingURL=index.js.map
+export{a as TemplateApi}from'./chunk-H55VIWDI.js';export{a as QrCodeApi}from'./chunk-I222VSWK.js';import'./chunk-W2U7MN7M.js';export{a as MessageStatus,e as WebhookHandler,f as generateXHub256Sig,d as processFlowRequest,c as processWebhookMessages,b as verifyWebhook}from'./chunk-TEJIY4ZS.js';import {b}from'./chunk-HEVRZRB4.js';import'./chunk-3MO3BTBC.js';import'./chunk-R36L2XYO.js';import'./chunk-GT3XQN7Y.js';export{b as RegistrationApi}from'./chunk-O2OTHNWM.js';export{b as EncryptionApi}from'./chunk-7NQLQPLH.js';export{b as TwoStepVerificationApi}from'./chunk-UQPD6GIF.js';export{b as WabaApi}from'./chunk-5JGM556C.js';export{b as MessagesApi}from'./chunk-2NJVBJUN.js';import'./chunk-XPPDOFBN.js';export{b as BusinessProfileApi}from'./chunk-KFPOVYEJ.js';import'./chunk-7GL74SXM.js';export{b as FlowApi}from'./chunk-A264MT4Q.js';export{b as PhoneNumberApi}from'./chunk-GIQLIMOD.js';import'./chunk-BZ5QDXNR.js';import'./chunk-VW3LGHTJ.js';export{q as AudioMediaTypesEnum,y as BusinessVerticalEnum,h as ButtonPositionEnum,g as ButtonTypesEnum,a as CategoryEnum,i as ComponentTypesEnum,k as ConversationTypesEnum,w as CurrencyCodesEnum,x as DataLocalizationRegionEnum,p as DocumentMediaTypesEnum,c as HttpMethodsEnum,o as ImageMediaTypesEnum,f as InteractiveTypesEnum,v as LanguagesEnum,d as MessageTypesEnum,e as ParametersTypesEnum,t as ReferralSourceTypesEnum,u as RequestCodeMethodsEnum,l as StatusEnum,n as StickerMediaTypesEnum,s as SystemChangeTypesEnum,b as TemplateStatusEnum,m as VideoMediaTypesEnum,j as WabaConfigEnum,r as WebhookTypesEnum}from'./chunk-SMHCU5MN.js';import'./chunk-4C666HHU.js';var se=b;export{se as default};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meta-cloud-api",
-  "version": "0.2.29",
+  "version": "0.2.30",
   "description": "TypeScript wrapper for Meta's Cloud API",
   "type": "module",
   "main": "./dist/index.js",

package/dist/chunk-NTQYJXAZ.js

@@ -1,3 +0,0 @@
-import {a as a$1,b}from'./chunk-HEVRZRB4.js';import {a}from'./chunk-VW3LGHTJ.js';import*as p from'crypto';import p__default from'crypto';var S=(t=>(t.DELIVERED="delivered",t.READ="read",t.SENT="sent",t))(S||{});function H(s){return typeof s=="object"&&s!==null}function m(s){return typeof s=="string"}var q=["data_exchange","INIT","BACK"],F=["data_exchange","INIT"];function v(s){if(!("flow_token"in s&&m(s.flow_token)&&"action"in s))return  false;let{action:e,version:o,screen:t,data:r}=s,a=o==="3.0",i=q.includes(e),g=typeof t>"u"||m(t)&&t!=="SUCCESS",d=e==="data_exchange"||H(r);return a&&i&&g&&d}function W(s){if(!("flow_token"in s&&m(s.flow_token)&&"action"in s))return  false;let{action:e,screen:o,data:t}=s,r=F.includes(e),a=m(o),i=H(t)&&"error_key"in t&&m(t.error)&&"error_message"in t&&m(t.error_message);return r&&a&&i}function T(s){return "action"in s&&s.action==="ping"}var I="WEBHOOK_UTILS",c=new a(I,process.env.DEBUG==="true");function w(s,e){let o=s.query["hub.mode"],t=s.query["hub.verify_token"],r=s.query["hub.challenge"];return o!==void 0&&t!==void 0&&r!==void 0?o==="subscribe"&&t===e?(c.log("Webhook verified successfully"),{statusCode:200,body:r}):(c.log("Webhook verification failed"),{statusCode:403}):(c.log("Not a webhook verification request - missing required parameters"),{statusCode:400,body:{error:"Invalid webhook verification request"}})}async function E(s,e,o){let t=s.body,r=[];if(t.object!=="whatsapp_business_account"){let a="Received webhook for non-WhatsApp event";return c.log(a),{statusCode:404,body:{error:a}}}for(let a of t.entry)try{let i=a.changes;for(let g of i)g.field==="messages"&&await P(a.id,g.value,e,o);}catch(i){let g=`Error processing webhook: ${i}`;c.log(g),r.push(g);}return {statusCode:200,body:r.length>0?{errors:r}:void 0}}async function k(s,e,o,t){try{if(!N(s,e.WEBHOOK_VERIFICATION_TOKEN||""))return c.log("Invalid request signature"),{statusCode:401,body:{error:"Unauthorized"}};let r=JSON.parse(s.rawBody||"{}"),{decryptedBody:a}=O(r,e),i=t.get("*");if(!i)return c.log(`No handler registered for flow action: ${a.action}`),{statusCode:404,body:{error:"Handler not found"}};if(T(a))return {statusCode:200,body:{version:"3.0",data:{status:"active"}}};if(W(a))return c.log(`Flow error: ${JSON.stringify(a)}`),{statusCode:200,body:{}};if(v(a)){let g=await i(o,a);return {statusCode:200,body:D(g,Buffer.from(r.aes_key,"base64"),Buffer.from(r.initial_vector,"base64"))}}return c.log(`Unknown flow request type: ${JSON.stringify(a)}`),{statusCode:400,body:{error:"Unknown request type"}}}catch(r){return c.log(`Error handling flow request: ${r}`),{statusCode:500,body:{error:"Internal server error"}}}}async function P(s,e,o,t){let r=e.metadata,a=e.contacts,i=s,g=r?.display_phone_number||"",d=r?.phone_number_id||"",f=a?.[0]?.profile?.name||"";if(e.statuses&&e.statuses.length>0){let u=e.statuses;for(let n of u){let l={wabaId:i,id:n.id,from:n.recipient_id,timestamp:n.timestamp,type:"statuses",phoneNumberId:d,displayPhoneNumber:g,profileName:f,statuses:e.statuses[0],originalData:n};await M(t.messageHandlers.get("statuses"),o,l,"statuses");}return}if(e.messages&&e.messages.length>0){let u=e.messages;for(let n of u){let l=n.type,y={wabaId:i,id:n.id,from:n.from,timestamp:n.timestamp,type:n.type,phoneNumberId:d,displayPhoneNumber:g,profileName:f,text:n.text,image:n.image,video:n.video,audio:n.audio,document:n.document,sticker:n.sticker,location:n.location,contacts:n.contacts,interactive:n.interactive,button:n.button,order:n.order,system:n.system,originalData:n};await M(t.preProcessHandler,o,y,"pre-process"),await M(t.messageHandlers.get(l),o,y,l),await M(t.postProcessHandler,o,y,"post-process");}}}async function M(s,e,o,t){if(s)try{await s(e,o);}catch(r){c.log(`Error in ${t} handler: ${r}`);}}function N(s,e){let o=s.headers["x-hub-signature-256"];if(!o||!s.rawBody)return  false;let r=`sha256=${p__default.createHmac("sha256",e).update(s.rawBody,"utf8").digest("hex")}`;return p__default.timingSafeEqual(Buffer.from(o),Buffer.from(r))}function O(s,e){let{encrypted_aes_key:o,encrypted_flow_data:t,initial_vector:r}=s;if(!o||!t||!r)throw new Error("Missing required encryption properties");let a=e.FLOW_API_PRIVATE_PEM.replace(/\\n/g,`
-`),i=e.FLOW_API_PASSPHRASE,g=p__default.createPrivateKey({key:a,passphrase:i}),d;try{d=p__default.privateDecrypt({key:g,padding:p__default.constants.RSA_PKCS1_OAEP_PADDING,oaepHash:"sha256"},Buffer.from(o,"base64"));}catch{throw new Error("Failed to decrypt the request. Please verify your private key.")}let f=Buffer.from(t,"base64"),u=Buffer.from(r,"base64"),l=f.subarray(0,-16),y=f.subarray(-16),_=p__default.createDecipheriv("aes-128-gcm",d,u);_.setAuthTag(y);let C=Buffer.concat([_.update(l),_.final()]).toString("utf-8");return {decryptedBody:JSON.parse(C),aesKeyBuffer:d,initialVectorBuffer:u}}function D(s,e,o){let t=[];for(let r of Array.from(o.entries()))t.push(~r[1]);try{let r=p__default.createCipheriv("aes-128-gcm",e,Buffer.from(t));return Buffer.concat([r.update(JSON.stringify(s||{}),"utf-8"),r.final(),r.getAuthTag()]).toString("base64")}catch(r){throw c.log("Response encryption error:",r),new Error("Failed to encrypt response. Internal server error.")}}var V="WEBHOOK",h=new a(V,process.env.DEBUG==="true"),R=class{config;client;messageHandlers=new Map;preProcessHandler=void 0;postProcessHandler=void 0;flowHandlers=new Map;constructor(e){this.config=a$1(e),this.client=new b(e),h.log("WebhookHandler instantiated!");}handleVerification=e=>w(e,this.config.WEBHOOK_VERIFICATION_TOKEN||"");handleWebhook=async e=>E(e,this.client,{messageHandlers:this.messageHandlers,preProcessHandler:this.preProcessHandler,postProcessHandler:this.postProcessHandler});handleFlow=async e=>k(e,this.config,this.client,this.flowHandlers);onMessage(e,o){this.messageHandlers.set(e,o),h.log(`Registered message handler for ${e}`);}onMessagePreProcess(e){this.preProcessHandler=e,h.log("Registered pre-process handler");}onMessagePostProcess(e){this.postProcessHandler=e,h.log("Registered post-process handler");}onFlow(e,o){this.flowHandlers.set(e,o),h.log(`Registered flow handler for ${e}`);}};var oe=(s,e)=>p.createHmac("sha256",e).update(s,"utf-8").digest("hex");export{S as a,w as b,E as c,k as d,R as e,oe as f};//# sourceMappingURL=chunk-NTQYJXAZ.js.map
-//# sourceMappingURL=chunk-NTQYJXAZ.js.map

package/dist/chunk-NTQYJXAZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/webhook/types.ts","../src/shared/utils/flowTypeGuards.ts","../src/core/webhook/utils/webhookUtils.ts","../src/core/webhook/WebhookHandler.ts","../src/core/webhook/utils/generateXHub256Sig.ts"],"names":["MessageStatus","isObject","value","isString","DATA_EXCHANGE_ACTIONS","ERROR_ACTIONS","isFlowDataExchangeRequest","request","action","version","screen","data","hasValidVersion","hasValidAction","hasValidScreen","hasValidData","isFlowErrorRequest","isFlowPingRequest","LIB_NAME","LOGGER","Logger","verifyWebhook","verificationToken","mode","token","challenge","processWebhookMessages","whatsapp","handlers","body","errors","errorMsg","entry","changes","change","processMessages","error","processFlowRequest","config","flowHandlers","isRequestSignatureValid","decryptedBody","decryptFlowRequest","handler","result","encryptFlowResponse","waba_id","metadata","contacts","wabaId","displayPhoneNumber","phoneNumberId","profileName","statuses","status","processedStatus","executeHandler","messages","message","messageType","processedMessage","handlerType","signature","formattedExpectedSignature","crypto","encrypted_aes_key","encrypted_flow_data","initial_vector","privatePem","passphrase","privateKey","decryptedAesKey","flowDataBuffer","initialVectorBuffer","TAG_LENGTH","encrypted_flow_data_body","encrypted_flow_data_tag","decipher","decryptedJSONString","response","aesKeyBuffer","flipped_iv","pair","cipher","WebhookHandler","importConfig","WhatsApp","type","generateXHub256Sig","appSecret","B"],"mappings":"yIAoyBYA,IAAAA,CAAAA,CAAAA,CAAAA,CAAAA,GACRA,EAAA,SAAY,CAAA,WAAA,CACZA,EAAA,IAAO,CAAA,MAAA,CACPA,CAAA,CAAA,IAAA,CAAO,MAHCA,CAAAA,CAAAA,CAAAA,EAAAA,CAAAA,EAAA,ICvxBZ,SAASC,CAAAA,CAASC,EAAkD,CAChE,OAAO,OAAOA,CAAU,EAAA,QAAA,EAAYA,CAAU,GAAA,IAClD,CAOA,SAASC,EAASD,CAAiC,CAAA,CAC/C,OAAO,OAAOA,CAAAA,EAAU,QAC5B,CAGA,IAAME,CAAwB,CAAA,CAAA,eAAA,CAAA,MAAA,CAAA,MAAuE,CAG/FC,CAAAA,CAAAA,CAAgB,uBAAkD,CASjE,CAAA,SAASC,EAA0BC,CAKxC,CAAA,CAEE,GAAI,EAAE,YAAA,GAAgBA,CAAWJ,EAAAA,CAAAA,CAASI,CAAQ,CAAA,UAAU,GAAK,QAAYA,GAAAA,CAAAA,CAAAA,CACzE,OAAO,MAGX,CAAA,GAAM,CAAE,MAAAC,CAAAA,CAAAA,CAAQ,OAAAC,CAAAA,CAAAA,CAAS,MAAAC,CAAAA,CAAAA,CAAQ,KAAAC,CAAK,CAAA,CAAIJ,EAGpCK,CAAkBH,CAAAA,CAAAA,GAAY,MAG9BI,CAAiBT,CAAAA,CAAAA,CAAsB,QAASI,CAAAA,CAAa,CAG7DM,CAAAA,CAAAA,CAAiB,OAAOJ,CAAW,CAAA,GAAA,EAAgBP,EAASO,CAAM,CAAA,EAAKA,IAAW,SAGlFK,CAAAA,CAAAA,CAAeP,CAAW,GAAA,eAAA,EAAgCP,CAASU,CAAAA,CAAI,EAG7E,OAAOC,CAAAA,EAAmBC,GAAkBC,CAAkBC,EAAAA,CAClE,CASO,SAASC,CAAAA,CAAmBT,CAQjC,CAAA,CAEE,GAAI,EAAE,eAAgBA,CAAWJ,EAAAA,CAAAA,CAASI,EAAQ,UAAU,CAAA,EAAK,WAAYA,CACzE,CAAA,CAAA,OAAO,MAGX,CAAA,GAAM,CAAE,MAAA,CAAAC,EAAQ,MAAAE,CAAAA,CAAAA,CAAQ,KAAAC,CAAK,CAAA,CAAIJ,EAG3BM,CAAiBR,CAAAA,CAAAA,CAAc,QAASG,CAAAA,CAAa,CAGrDM,CAAAA,CAAAA,CAAiBX,EAASO,CAAM,CAAA,CAGhCK,EACFd,CAASU,CAAAA,CAAI,GACb,WAAeA,GAAAA,CAAAA,EACfR,CAASQ,CAAAA,CAAAA,CAAK,KAAK,CAAA,EACnB,kBAAmBA,CACnBR,EAAAA,CAAAA,CAASQ,EAAK,aAAa,CAAA,CAG/B,OAAOE,CAAkBC,EAAAA,CAAAA,EAAkBC,CAC/C,CASO,SAASE,CAAAA,CAAkBV,EAAiE,CAE/F,OAAO,WAAYA,CAAWA,EAAAA,CAAAA,CAAQ,SAAW,MACrD,CC7GA,IAAMW,EAAW,eACXC,CAAAA,CAAAA,CAAS,IAAIC,CAAOF,CAAAA,CAAAA,CAAU,QAAQ,GAAI,CAAA,KAAA,GAAU,MAAM,CAAA,CAsBzD,SAASG,CAAAA,CAAcd,EAAwCe,CAA4C,CAAA,CAC9G,IAAMC,CAAOhB,CAAAA,CAAAA,CAAQ,MAAM,UAAU,CAAA,CAC/BiB,CAAQjB,CAAAA,CAAAA,CAAQ,KAAM,CAAA,kBAAkB,EACxCkB,CAAYlB,CAAAA,CAAAA,CAAQ,MAAM,eAAe,CAAA,CAK/C,OAFqCgB,CAAS,GAAA,MAAA,EAAaC,CAAU,GAAA,MAAA,EAAaC,CAAc,GAAA,MAAA,CAUnEF,IAAS,WAAeC,EAAAA,CAAAA,GAAUF,GAG3DH,CAAO,CAAA,GAAA,CAAI,+BAA+B,CACnC,CAAA,CACH,UAAY,CAAA,GAAA,CACZ,IAAMM,CAAAA,CACV,IAEAN,CAAO,CAAA,GAAA,CAAI,6BAA6B,CACjC,CAAA,CACH,WAAY,GAChB,CAAA,CAAA,EAnBAA,CAAO,CAAA,GAAA,CAAI,kEAAkE,CAAA,CACtE,CACH,UAAY,CAAA,GAAA,CACZ,KAAM,CAAE,KAAA,CAAO,sCAAuC,CAC1D,CAAA,CAiBR,CAKA,eAAsBO,CAClBnB,CAAAA,CAAAA,CACAoB,EACAC,CAKwB,CAAA,CACxB,IAAMC,CAAOtB,CAAAA,CAAAA,CAAQ,KACfuB,CAAmB,CAAA,EAGzB,CAAA,GAAID,CAAK,CAAA,MAAA,GAAW,4BAA6B,CAC7C,IAAME,EAAW,yCACjB,CAAA,OAAAZ,EAAO,GAAIY,CAAAA,CAAQ,CACZ,CAAA,CACH,UAAY,CAAA,GAAA,CACZ,KAAM,CAAE,KAAA,CAAOA,CAAS,CAC5B,CACJ,CAGA,IAAWC,IAAAA,CAAAA,IAASH,CAAK,CAAA,KAAA,CACrB,GAAI,CACA,IAAMI,CAAUD,CAAAA,CAAAA,CAAM,QACtB,IAAWE,IAAAA,CAAAA,IAAUD,EACbC,CAAO,CAAA,KAAA,GAAU,UACjB,EAAA,MAAMC,CAAgBH,CAAAA,CAAAA,CAAM,GAAIE,CAAO,CAAA,KAAA,CAAOP,EAAUC,CAAQ,EAG5E,OAASQ,CAAO,CAAA,CACZ,IAAML,CAAAA,CAAW,CAA6BK,0BAAAA,EAAAA,CAAK,GACnDjB,CAAO,CAAA,GAAA,CAAIY,CAAQ,CACnBD,CAAAA,CAAAA,CAAO,KAAKC,CAAQ,EACxB,CAGJ,OAAO,CACH,UAAA,CAAY,IACZ,IAAMD,CAAAA,CAAAA,CAAO,OAAS,CAAI,CAAA,CAAE,OAAAA,CAAO,CAAA,CAAI,MAC3C,CACJ,CAKA,eAAsBO,EAClB9B,CACA+B,CAAAA,CAAAA,CACAX,EACAY,CACwB,CAAA,CACxB,GAAI,CAEA,GAAI,CAACC,CAAAA,CAAwBjC,CAAS+B,CAAAA,CAAAA,CAAO,4BAA8B,EAAE,CAAA,CACzE,OAAAnB,CAAO,CAAA,GAAA,CAAI,2BAA2B,CAC/B,CAAA,CACH,UAAY,CAAA,GAAA,CACZ,IAAM,CAAA,CAAE,MAAO,cAAe,CAClC,EAGJ,IAAMU,CAAAA,CAAO,KAAK,KAAMtB,CAAAA,CAAAA,CAAQ,OAAW,EAAA,IAAI,CAGzC,CAAA,CAAE,cAAAkC,CAAc,CAAA,CAAIC,EAAmBb,CAAMS,CAAAA,CAAM,EAGnDK,CAAUJ,CAAAA,CAAAA,CAAa,GAAoB,CAAA,GAAA,CAAA,CACjD,GAAI,CAACI,EACD,OAAAxB,CAAAA,CAAO,IAAI,CAA0CsB,uCAAAA,EAAAA,CAAAA,CAAc,MAAM,CAAE,CAAA,CAAA,CACpE,CACH,UAAA,CAAY,GACZ,CAAA,IAAA,CAAM,CAAE,KAAO,CAAA,mBAAoB,CACvC,CAIJ,CAAA,GAAIxB,EAAkBwB,CAAa,CAAA,CAC/B,OAAO,CACH,UAAY,CAAA,GAAA,CACZ,KAAM,CACF,OAAA,CAAS,MACT,IAAM,CAAA,CAAE,OAAQ,QAAS,CAC7B,CACJ,CAAA,CAGJ,GAAIzB,CAAAA,CAAmByB,CAAa,CAChC,CAAA,OAAAtB,EAAO,GAAI,CAAA,CAAA,YAAA,EAAe,KAAK,SAAUsB,CAAAA,CAAa,CAAC,CAAA,CAAE,CAClD,CAAA,CACH,WAAY,GACZ,CAAA,IAAA,CAAM,EACV,CAAA,CAGJ,GAAInC,CAA0BmC,CAAAA,CAAa,CAAG,CAAA,CAC1C,IAAMG,CAAAA,CAAS,MAAMD,CAAQhB,CAAAA,CAAAA,CAAUc,CAAa,CAOpD,CAAA,OAAO,CACH,UAAY,CAAA,GAAA,CACZ,IARsBI,CAAAA,CAAAA,CACtBD,CACA,CAAA,MAAA,CAAO,KAAKf,CAAK,CAAA,OAAA,CAAS,QAAQ,CAClC,CAAA,MAAA,CAAO,KAAKA,CAAK,CAAA,cAAA,CAAgB,QAAQ,CAC7C,CAKA,CACJ,CAEA,OAAAV,CAAAA,CAAO,IAAI,CAA8B,2BAAA,EAAA,IAAA,CAAK,UAAUsB,CAAa,CAAC,CAAE,CAAA,CAAA,CACjE,CACH,UAAA,CAAY,IACZ,IAAM,CAAA,CAAE,MAAO,sBAAuB,CAC1C,CACJ,CAASL,MAAAA,CAAAA,CAAO,CACZ,OAAAjB,CAAO,CAAA,GAAA,CAAI,gCAAgCiB,CAAK,CAAA,CAAE,EAC3C,CACH,UAAA,CAAY,IACZ,IAAM,CAAA,CAAE,KAAO,CAAA,uBAAwB,CAC3C,CACJ,CACJ,CAKA,eAAeD,EACXW,CACA5C,CAAAA,CAAAA,CACAyB,EACAC,CAKa,CAAA,CACb,IAAMmB,CAAAA,CAAW7C,CAAM,CAAA,QAAA,CACjB8C,EAAW9C,CAAM,CAAA,QAAA,CACjB+C,EAASH,CACTI,CAAAA,CAAAA,CAAqBH,GAAU,oBAAwB,EAAA,EAAA,CACvDI,CAAgBJ,CAAAA,CAAAA,EAAU,eAAmB,EAAA,EAAA,CAC7CK,EAAcJ,CAAW,GAAA,CAAC,GAAG,OAAS,EAAA,IAAA,EAAQ,GAEpD,GAAI9C,CAAAA,CAAM,QAAYA,EAAAA,CAAAA,CAAM,QAAS,CAAA,MAAA,CAAS,EAAG,CAC7C,IAAMmD,EAAWnD,CAAM,CAAA,QAAA,CACvB,QAAWoD,CAAUD,IAAAA,CAAAA,CAAU,CAC3B,IAAME,CAAkC,CAAA,CACpC,OAAAN,CACA,CAAA,EAAA,CAAIK,EAAO,EACX,CAAA,IAAA,CAAMA,EAAO,YACb,CAAA,SAAA,CAAWA,CAAO,CAAA,SAAA,CAClB,IACA,CAAA,UAAA,CAAA,aAAA,CAAAH,EACA,kBAAAD,CAAAA,CAAAA,CACA,YAAAE,CACA,CAAA,QAAA,CAAUlD,EAAM,QAAS,CAAA,CAAC,CAC1B,CAAA,YAAA,CAAcoD,CAClB,CAAA,CAEA,MAAME,CACF5B,CAAAA,CAAAA,CAAS,gBAAgB,GAA6B,CAAA,UAAA,CAAA,CACtDD,EACA4B,CAEJ,CAAA,UAAA,EACJ,CACA,MACJ,CAEA,GAAIrD,EAAM,QAAYA,EAAAA,CAAAA,CAAM,SAAS,MAAS,CAAA,CAAA,CAAG,CAC7C,IAAMuD,CAAAA,CAAWvD,CAAM,CAAA,QAAA,CAEvB,IAAWwD,IAAAA,CAAAA,IAAWD,EAAU,CAC5B,IAAME,EAAcD,CAAQ,CAAA,IAAA,CAEtBE,EAAmC,CACrC,MAAA,CAAAX,CACA,CAAA,EAAA,CAAIS,CAAQ,CAAA,EAAA,CACZ,KAAMA,CAAQ,CAAA,IAAA,CACd,UAAWA,CAAQ,CAAA,SAAA,CACnB,KAAMA,CAAQ,CAAA,IAAA,CACd,aAAAP,CAAAA,CAAAA,CACA,kBAAAD,CAAAA,CAAAA,CACA,YAAAE,CACA,CAAA,IAAA,CAAMM,EAAQ,IACd,CAAA,KAAA,CAAOA,EAAQ,KACf,CAAA,KAAA,CAAOA,CAAQ,CAAA,KAAA,CACf,KAAOA,CAAAA,CAAAA,CAAQ,MACf,QAAUA,CAAAA,CAAAA,CAAQ,SAClB,OAASA,CAAAA,CAAAA,CAAQ,QACjB,QAAUA,CAAAA,CAAAA,CAAQ,QAClB,CAAA,QAAA,CAAUA,CAAQ,CAAA,QAAA,CAClB,YAAaA,CAAQ,CAAA,WAAA,CACrB,OAAQA,CAAQ,CAAA,MAAA,CAChB,MAAOA,CAAQ,CAAA,KAAA,CACf,MAAQA,CAAAA,CAAAA,CAAQ,MAChB,CAAA,YAAA,CAAcA,CAClB,CAGA,CAAA,MAAMF,EAAe5B,CAAS,CAAA,iBAAA,CAAmBD,EAAUiC,CAAkB,CAAA,aAAa,CAC1F,CAAA,MAAMJ,CAAe5B,CAAAA,CAAAA,CAAS,gBAAgB,GAAI+B,CAAAA,CAAW,EAAGhC,CAAUiC,CAAAA,CAAAA,CAAkBD,CAAW,CACvG,CAAA,MAAMH,CAAe5B,CAAAA,CAAAA,CAAS,kBAAoBD,CAAAA,CAAAA,CAAUiC,EAAkB,cAAc,EAChG,CACJ,CACJ,CAEA,eAAeJ,CACXb,CAAAA,CAAAA,CACAhB,CACA+B,CAAAA,CAAAA,CACAG,CACa,CAAA,CACb,GAAIlB,CACA,CAAA,GAAI,CACA,MAAMA,CAAAA,CAAQhB,EAAU+B,CAAO,EACnC,CAAStB,MAAAA,CAAAA,CAAO,CACZjB,CAAAA,CAAO,IAAI,CAAY0C,SAAAA,EAAAA,CAAW,aAAazB,CAAK,CAAA,CAAE,EAC1D,CAER,CAEA,SAASI,CAAAA,CAAwBjC,CAAyBe,CAAAA,CAAAA,CAAoC,CAC1F,IAAMwC,CAAAA,CAAYvD,EAAQ,OAAQ,CAAA,qBAAqB,EACvD,GAAI,CAACuD,CAAa,EAAA,CAACvD,CAAQ,CAAA,OAAA,CACvB,OAAO,MAQX,CAAA,IAAMwD,EAA6B,CALTC,OAAAA,EAAAA,UAAAA,CACrB,WAAW,QAAU1C,CAAAA,CAAiB,CACtC,CAAA,MAAA,CAAOf,CAAQ,CAAA,OAAA,CAAS,MAAM,CAC9B,CAAA,MAAA,CAAO,KAAK,CAE6C,CAAA,CAAA,CAE9D,OAAOyD,UAAO,CAAA,eAAA,CAAgB,MAAO,CAAA,IAAA,CAAKF,CAAS,CAAA,CAAG,OAAO,IAAKC,CAAAA,CAA0B,CAAC,CACjG,CAEA,SAASrB,CACLb,CAAAA,CAAAA,CACAS,CAKF,CAAA,CACE,GAAM,CAAE,kBAAA2B,CAAmB,CAAA,mBAAA,CAAAC,EAAqB,cAAAC,CAAAA,CAAe,EAAItC,CAEnE,CAAA,GAAI,CAACoC,CAAAA,EAAqB,CAACC,CAAAA,EAAuB,CAACC,CAC/C,CAAA,MAAM,IAAI,KAAA,CAAM,wCAAwC,CAAA,CAG5D,IAAMC,CAAa9B,CAAAA,CAAAA,CAAO,oBAAqB,CAAA,OAAA,CAAQ,MAAQ,CAAA;AAAA,CAAI,EAC7D+B,CAAa/B,CAAAA,CAAAA,CAAO,oBAEpBgC,CAAaN,CAAAA,UAAAA,CAAO,iBAAiB,CAAE,GAAA,CAAKI,CAAY,CAAA,UAAA,CAAAC,CAAW,CAAC,CAAA,CACtEE,EAEJ,GAAI,CACAA,EAAkBP,UAAO,CAAA,cAAA,CACrB,CACI,GAAA,CAAKM,EACL,OAASN,CAAAA,UAAAA,CAAO,UAAU,sBAC1B,CAAA,QAAA,CAAU,QACd,CACA,CAAA,MAAA,CAAO,IAAKC,CAAAA,CAAAA,CAAmB,QAAQ,CAC3C,EACJ,MAAgB,CACZ,MAAM,IAAI,KAAM,CAAA,gEAAgE,CACpF,KAEMO,CAAiB,CAAA,MAAA,CAAO,KAAKN,CAAqB,CAAA,QAAQ,EAC1DO,CAAsB,CAAA,MAAA,CAAO,IAAKN,CAAAA,CAAAA,CAAgB,QAAQ,CAE1DO,CACAC,CAA2BH,CAAAA,CAAAA,CAAe,SAAS,CAAG,CAAA,GAAW,CAAA,CACjEI,EAA0BJ,CAAe,CAAA,QAAA,CAAS,GAAW,CAAA,CAE7DK,EAAWb,UAAO,CAAA,gBAAA,CAAiB,aAAeO,CAAAA,CAAAA,CAAiBE,CAAmB,EAC5FI,CAAAA,CAAS,WAAWD,CAAuB,CAAA,CAE3C,IAAME,CAAsB,CAAA,MAAA,CAAO,MAAO,CAAA,CAACD,EAAS,MAAOF,CAAAA,CAAwB,EAAGE,CAAS,CAAA,KAAA,EAAO,CAAC,CAAA,CAAE,QACrG,CAAA,OACJ,EAEA,OAAO,CACH,cAAe,IAAK,CAAA,KAAA,CAAMC,CAAmB,CAC7C,CAAA,YAAA,CAAcP,CACd,CAAA,mBAAA,CAAAE,CACJ,CACJ,CAEA,SAAS5B,CAAoBkC,CAAAA,CAAAA,CAAeC,EAAsBP,CAAqC,CAAA,CACnG,IAAMQ,CAAAA,CAAuB,EAC7B,CAAA,IAAA,IAAWC,KAAQ,KAAM,CAAA,IAAA,CAAKT,EAAoB,OAAQ,EAAC,CACvDQ,CAAAA,CAAAA,CAAW,KAAK,CAACC,CAAAA,CAAK,CAAC,CAAC,CAAA,CAG5B,GAAI,CACA,IAAMC,CAASnB,CAAAA,UAAAA,CAAO,eAAe,aAAegB,CAAAA,CAAAA,CAAc,OAAO,IAAKC,CAAAA,CAAU,CAAC,CACzF,CAAA,OAAO,MAAO,CAAA,MAAA,CAAO,CACjBE,CAAO,CAAA,MAAA,CAAO,KAAK,SAAUJ,CAAAA,CAAAA,EAAY,EAAE,CAAA,CAAG,OAAO,CACrDI,CAAAA,CAAAA,CAAO,OACPA,CAAAA,CAAAA,CAAO,YACX,CAAC,EAAE,QAAS,CAAA,QAAQ,CACxB,CAAA,MAAS/C,EAAO,CACZ,MAAAjB,EAAO,GAAI,CAAA,4BAAA,CAA8BiB,CAAK,CACxC,CAAA,IAAI,KAAM,CAAA,oDAAoD,CACxE,CACJ,KC3WMlB,CAAW,CAAA,SAAA,CACXC,EAAS,IAAIC,CAAAA,CAAOF,CAAU,CAAA,OAAA,CAAQ,IAAI,KAAU,GAAA,MAAM,EAKnDkE,CAAN,CAAA,KAAqB,CAChB,MACA,CAAA,MAAA,CACA,eAAyD,CAAA,IAAI,IAC7D,iBAAgD,CAAA,MAAA,CAChD,mBAAiD,MACjD,CAAA,YAAA,CAA+C,IAAI,GAE3D,CAAA,WAAA,CAAY9C,CAAwB,CAAA,CAChC,KAAK,MAAS+C,CAAAA,GAAAA,CAAa/C,CAAM,CACjC,CAAA,IAAA,CAAK,OAAS,IAAIgD,CAAAA,CAAShD,CAAM,CAAA,CACjCnB,EAAO,GAAI,CAAA,8BAA8B,EAC7C,CAKO,kBAAA,CAAsBZ,GAClBc,CAAcd,CAAAA,CAAAA,CAAS,IAAK,CAAA,MAAA,CAAO,4BAA8B,EAAE,CAAA,CAMvE,cAAgB,MAAOA,CAAAA,EACnBmB,EAAuBnB,CAAS,CAAA,IAAA,CAAK,OAAQ,CAChD,eAAA,CAAiB,KAAK,eACtB,CAAA,iBAAA,CAAmB,KAAK,iBACxB,CAAA,kBAAA,CAAoB,KAAK,kBAC7B,CAAC,CAME,CAAA,UAAA,CAAa,MAAOA,CAChB8B,EAAAA,CAAAA,CAAmB9B,EAAS,IAAK,CAAA,MAAA,CAAQ,KAAK,MAAQ,CAAA,IAAA,CAAK,YAAY,CAAA,CAM3E,UAAUgF,CAAwB5C,CAAAA,CAAAA,CAA+B,CACpE,IAAK,CAAA,eAAA,CAAgB,IAAI4C,CAAM5C,CAAAA,CAAO,CACtCxB,CAAAA,CAAAA,CAAO,IAAI,CAAkCoE,+BAAAA,EAAAA,CAAI,EAAE,EACvD,CAKO,oBAAoB5C,CAA+B,CAAA,CACtD,IAAK,CAAA,iBAAA,CAAoBA,EACzBxB,CAAO,CAAA,GAAA,CAAI,gCAAgC,EAC/C,CAKO,qBAAqBwB,CAA+B,CAAA,CACvD,IAAK,CAAA,kBAAA,CAAqBA,EAC1BxB,CAAO,CAAA,GAAA,CAAI,iCAAiC,EAChD,CAKO,OAAOoE,CAAoB5C,CAAAA,CAAAA,CAA4B,CAC1D,IAAA,CAAK,aAAa,GAAI4C,CAAAA,CAAAA,CAAM5C,CAAO,CACnCxB,CAAAA,CAAAA,CAAO,IAAI,CAA+BoE,4BAAAA,EAAAA,CAAI,CAAE,CAAA,EACpD,CACJ,EC1FO,IAAMC,GAAqB,CAAC3D,CAAAA,CAAc4D,IAC/BC,CAAW,CAAA,UAAA,CAAA,QAAA,CAAUD,CAAS,CAAE,CAAA,MAAA,CAAO5D,EAAM,OAAO,CAAA,CAAE,OAAO,KAAK","file":"chunk-NTQYJXAZ.js","sourcesContent":["import { MessageTypesEnum } from '@shared/types/enums';\n\nexport interface WebhookContact {\n    /**\n     * WhatsApp ID of the contact. Business can respond to this contact using this ID.\n     */\n    wa_id: string;\n    /**\n     *  Additional unique, alphanumeric identifier for a WhatsApp user\n     */\n    user_id?: string;\n    /**\n     * Profile of Whatsapp user\n     */\n    profile: {\n        /**\n         * The display name of the contact\n         */\n        name: string;\n    };\n}\n\n/**\n * Base message interface with common properties\n */\nexport interface BaseMessage {\n    id: string;\n    from: string;\n    timestamp: string;\n    type: MessageTypesEnum;\n    /**\n     * Context object, included when a user replies or interacts\n     */\n    context?: {\n        /**\n         * ID of the message\n         */\n        id?: string;\n        /**\n         * ID of the sender\n         */\n        from?: string;\n        /**\n         * ID of the message being replied to or interacted with\n         */\n        message_id: string;\n        /**\n         * ID of the forwarded message, if applicable\n         */\n        forwarded?: boolean;\n        /**\n         * Frequently forwarded status\n         */\n        frequently_forwarded?: boolean;\n        /**\n         * Original message information if the message was referred\n         */\n        referred_product?: {\n            /**\n             * Catalog ID\n             */\n            catalog_id: string;\n            /**\n             * Product ID\n             */\n            product_retailer_id: string;\n        };\n    };\n    /**\n     * Errors array, if the message had errors\n     */\n    errors?: Array<{\n        /**\n         * Error code\n         */\n        code: number;\n        /**\n         * Error title\n         */\n        title: string;\n        /**\n         * Error message\n         */\n        message: string;\n        /**\n         * Error details object\n         */\n        error_data?: {\n            /**\n             * Describes the error details\n             */\n            details: string;\n        };\n    }>;\n}\n\n/**\n * Text message interface\n */\nexport interface TextMessage extends BaseMessage {\n    type: MessageTypesEnum.Text;\n    text: {\n        /**\n         * The text content of the message\n         */\n        body: string;\n        preview_url?: boolean;\n    };\n}\n\n/**\n * Image message interface\n */\nexport interface ImageMessage extends BaseMessage {\n    type: MessageTypesEnum.Image;\n    image: {\n        /**\n         * The image caption (if provided)\n         */\n        caption?: string;\n        /**\n         * The SHA256 hash of the image\n         */\n        sha256?: string;\n        /**\n         * The ID for the image\n         */\n        id: string;\n        /**\n         * The MIME type of the image\n         */\n        mime_type: string;\n    };\n}\n\n/**\n * Video message interface\n */\nexport interface VideoMessage extends BaseMessage {\n    type: MessageTypesEnum.Video;\n    video: {\n        /**\n         * The video caption (if provided)\n         */\n        caption?: string;\n        /**\n         * The SHA256 hash of the video\n         */\n        sha256?: string;\n        /**\n         * The ID for the video\n         */\n        id: string;\n        /**\n         * The MIME type of the video\n         */\n        mime_type: string;\n    };\n}\n\n/**\n * Audio message interface\n */\nexport interface AudioMessage extends BaseMessage {\n    type: MessageTypesEnum.Audio;\n    audio: {\n        /**\n         * The ID for the audio file\n         */\n        id: string;\n        /**\n         * The MIME type of the audio file\n         */\n        mime_type: string;\n        /**\n         * Whether the audio is a voice message\n         */\n        voice?: boolean;\n    };\n}\n\n/**\n * Document message interface\n */\nexport interface DocumentMessage extends BaseMessage {\n    type: MessageTypesEnum.Document;\n    document: {\n        /**\n         * The document caption (if provided)\n         */\n        caption?: string;\n        /**\n         * The document filename\n         */\n        filename: string;\n        /**\n         * The SHA256 hash of the document\n         */\n        sha256?: string;\n        /**\n         * The ID for the document\n         */\n        id: string;\n        /**\n         * The MIME type of the document\n         */\n        mime_type: string;\n    };\n}\n\n/**\n * Sticker message interface\n */\nexport interface StickerMessage extends BaseMessage {\n    type: MessageTypesEnum.Sticker;\n    sticker: {\n        /**\n         * The ID for the sticker\n         */\n        id: string;\n        /**\n         * Whether this is an animated sticker\n         */\n        animated: boolean;\n        /**\n         * The MIME type of the sticker\n         */\n        mime_type: string;\n    };\n}\n\n/**\n * Reaction message interface\n */\nexport interface ReactionMessage extends BaseMessage {\n    type: MessageTypesEnum.Reaction;\n    reaction: {\n        /**\n         * The ID of the message being reacted to\n         */\n        message_id: string;\n        /**\n         * Emoji used for the reaction\n         */\n        emoji: string;\n    };\n}\n\n/**\n * Contacts message interface\n */\nexport interface ContactsMessage extends BaseMessage {\n    type: MessageTypesEnum.Contacts;\n    contacts: Array<{\n        /**\n         * The contact's name\n         */\n        name: {\n            /**\n             * The formatted name\n             */\n            formatted_name: string;\n            /**\n             * The first name\n             */\n            first_name?: string;\n            /**\n             * The last name\n             */\n            last_name?: string;\n            /**\n             * The middle name\n             */\n            middle_name?: string;\n            /**\n             * The suffix\n             */\n            suffix?: string;\n            /**\n             * The prefix\n             */\n            prefix?: string;\n        };\n        /**\n         * The contact's phone numbers\n         */\n        phones?: Array<{\n            phone: string;\n            type?: string;\n            wa_id?: string;\n        }>;\n        /**\n         * The contact's emails\n         */\n        emails?: Array<{\n            email: string;\n            type?: string;\n        }>;\n        /**\n         * The contact's addresses\n         */\n        addresses?: Array<{\n            street?: string;\n            city?: string;\n            state?: string;\n            zip?: string;\n            country?: string;\n            country_code?: string;\n            type?: string;\n        }>;\n        /**\n         * The contact's organizations\n         */\n        org?: {\n            company?: string;\n            department?: string;\n            title?: string;\n        };\n        /**\n         * The contact's URLs\n         */\n        urls?: Array<{\n            url: string;\n            type?: string;\n        }>;\n        /**\n         * The contact's birthday (YYYY-MM-DD format)\n         */\n        birthday?: string;\n    }>;\n}\n\n/**\n * Location message interface\n */\nexport interface LocationMessage extends BaseMessage {\n    type: MessageTypesEnum.Location;\n    location: {\n        /**\n         * Latitude of the location\n         */\n        latitude: number;\n        /**\n         * Longitude of the location\n         */\n        longitude: number;\n        /**\n         * Name of the location\n         */\n        name?: string;\n        /**\n         * Address of the location\n         */\n        address?: string;\n    };\n}\n\n/**\n * Interactive message interface\n */\nexport interface InteractiveMessage extends BaseMessage {\n    type: MessageTypesEnum.Interactive;\n    interactive: {\n        /**\n         * Type of the interactive message\n         * Can be: button_reply, list_reply, flow, nfm_reply, etc.\n         */\n        type: string;\n        /**\n         * ID for the button that was clicked\n         */\n        button_reply?: {\n            id: string;\n            title: string;\n        };\n        /**\n         * ID for the list item that was selected\n         */\n        list_reply?: {\n            id: string;\n            title: string;\n            description?: string;\n        };\n        /**\n         * NFM (No-Code Flow Message) reply data\n         */\n        nfm_reply?: {\n            /**\n             * Response data in JSON format\n             */\n            response_json: string;\n            /**\n             * Body text of the reply\n             */\n            body: string;\n            /**\n             * Name of the flow\n             */\n            name: string;\n        };\n    };\n}\n\n/**\n * System message interface\n */\nexport interface SystemMessage extends BaseMessage {\n    type: MessageTypesEnum.System;\n    system: {\n        /**\n         * The type of system update\n         */\n        type: string;\n        /**\n         * User's identity if the update is a customer identity change\n         */\n        identity?: string;\n        /**\n         * Old and new phone numbers if the update is a phone number change\n         */\n        customer?: {\n            /**\n             * The previous phone number\n             */\n            previous_wa_id: string;\n            /**\n             * The new phone number\n             */\n            wa_id: string;\n        };\n    };\n}\n\n/**\n * Order message interface\n */\nexport interface OrderMessage extends BaseMessage {\n    type: MessageTypesEnum.Order;\n    order: {\n        /**\n         * Catalog ID\n         */\n        catalog_id: string;\n        /**\n         * Product items in the order\n         */\n        product_items: Array<{\n            /**\n             * Product ID\n             */\n            product_retailer_id: string;\n            /**\n             * Quantity of the product\n             */\n            quantity: number;\n            /**\n             * Item price\n             */\n            item_price: number;\n            /**\n             * Currency code\n             */\n            currency: string;\n        }>;\n        /**\n         * Text message included with the order\n         */\n        text?: string;\n    };\n}\n\n/**\n * Button message interface\n */\nexport interface ButtonMessage extends BaseMessage {\n    type: MessageTypesEnum.Button;\n    button: {\n        /**\n         * The payload for the button\n         */\n        payload: string;\n        /**\n         * Button text\n         */\n        text: string;\n    };\n}\n\n/**\n * Union type for all message types\n */\nexport type WhatsAppMessage =\n    | TextMessage\n    | ImageMessage\n    | VideoMessage\n    | AudioMessage\n    | DocumentMessage\n    | StickerMessage\n    | ReactionMessage\n    | ContactsMessage\n    | LocationMessage\n    | InteractiveMessage\n    | SystemMessage\n    | OrderMessage\n    | ButtonMessage;\n\nexport interface WebhookMessageValue {\n    /**\n     * The messaging product\n     */\n    messaging_product: string;\n    /**\n     * The metadata\n     */\n    metadata: {\n        /**\n         * The display phone number of the whatsapp business account\n         */\n        display_phone_number: string;\n        /**\n         * The phone number ID of the whatsapp business account\n         */\n        phone_number_id: string;\n    };\n    contacts?: Array<{\n        profile: {\n            /**\n             * The display name of the whatsapp user\n             */\n            name: string;\n        };\n        /**\n         * The whatsapp ID of the user\n         */\n        wa_id: string;\n    }>;\n    messages: Array<{\n        from: string;\n        id: string;\n        timestamp: string;\n        type: MessageTypesEnum;\n        text?: TextMessage;\n        image?: ImageMessage;\n        video?: VideoMessage;\n        audio?: AudioMessage;\n        document?: DocumentMessage;\n        sticker?: StickerMessage;\n        location?: LocationMessage;\n        contacts?: ContactsMessage;\n        interactive?: InteractiveMessage;\n        button?: ButtonMessage;\n        order?: OrderMessage;\n        system?: SystemMessage;\n        reaction?: ReactionMessage;\n    }>;\n\n    statuses?: Array<{\n        /**\n         * The ID of the message\n         */\n        id: string;\n        /**\n         * The status of the message\n         */\n        status: MessageStatus;\n        /**\n         * The timestamp of the message\n         */\n        timestamp: string;\n        /**\n         * The recipient ID ( phone number of the user )\n         */\n        recipient_id: string;\n    }>;\n\n    errors?: Array<{\n        /**\n         * The error code\n         */\n        code: number;\n        /**\n         * The error title\n         */\n        title: string;\n        /**\n         * The error data\n         */\n        error_data?: {\n            /**\n             * The error details\n             */\n            details: string;\n        };\n    }>;\n}\n\n/**\n * Represents a message received through the webhook\n * Based on Meta's documentation: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components#messages-object\n */\nexport interface WebhookMessage {\n    /**\n     * The WhatsApp Business Account ID\n     */\n    wabaId: string;\n\n    /**\n     * The message ID\n     */\n    id: string;\n\n    /**\n     * The sender's phone number\n     */\n    from: string;\n\n    /**\n     * The timestamp of the message\n     */\n    timestamp: string;\n\n    /**\n     * The type of message (text, image, etc.)\n     */\n    type: MessageTypesEnum;\n\n    /**\n     * The phone number ID that received the message\n     */\n    phoneNumberId: string;\n\n    /**\n     * The display phone number that received the message\n     */\n    displayPhoneNumber: string;\n\n    /**\n     * The profile name of the sender\n     */\n    profileName: string;\n\n    text?: TextMessage;\n    image?: ImageMessage;\n    video?: VideoMessage;\n    audio?: AudioMessage;\n    document?: DocumentMessage;\n    sticker?: StickerMessage;\n    location?: LocationMessage;\n    contacts?: ContactsMessage;\n    interactive?: InteractiveMessage;\n    button?: ButtonMessage;\n    order?: OrderMessage;\n    system?: SystemMessage;\n\n    statuses?: {\n        /**\n         * Arbitrary string included in sent message\n         */\n        biz_opaque_callback_data?: string;\n\n        /**\n         * Information about the conversation\n         */\n        conversation?: {\n            /**\n             * Represents the ID of the conversation the given status notification belongs to\n             */\n            id: string;\n            /**\n             * Describes conversation category\n             */\n            origin: {\n                /**\n                 * Indicates conversation category. This can also be referred to as a conversation entry point\n                 * - authentication: Conversation opened by business sending template categorized as AUTHENTICATION\n                 * - marketing: Conversation opened by business sending template categorized as MARKETING\n                 * - utility: Conversation opened by business sending template categorized as UTILITY\n                 * - service: Conversation opened by business replying to customer within service window\n                 * - referral_conversion: Free entry point conversation\n                 */\n                type: 'authentication' | 'marketing' | 'utility' | 'service' | 'referral_conversion';\n            };\n            /**\n             * Date when the conversation expires. Only present for messages with status 'sent'\n             */\n            expiration_timestamp?: string;\n        };\n\n        /**\n         * Array of error objects describing the error\n         */\n        errors?: Array<{\n            /**\n             * Error code\n             */\n            code: number;\n            /**\n             * Error code title\n             */\n            title: string;\n            /**\n             * Error code message\n             */\n            message: string;\n            /**\n             * Error details object\n             */\n            error_data?: {\n                /**\n                 * Describes the error details\n                 */\n                details: string;\n            };\n        }>;\n\n        /**\n         * The ID for the message that the business sent to a customer\n         */\n        id: string;\n\n        /**\n         * Pricing information for the message/conversation\n         */\n        pricing?: {\n            /**\n             * Indicates if the given message or conversation is billable\n             * @deprecated This field is deprecated. Visit the WhatsApp Changelog for more information.\n             */\n            billable?: boolean;\n            /**\n             * Indicates the conversation category:\n             * - authentication: Authentication conversation\n             * - authentication_international: Authentication-international conversation\n             * - marketing: Marketing conversation\n             * - utility: Utility conversation\n             * - service: Service conversation\n             * - referral_conversion: Free entry point conversation\n             */\n            category:\n                | 'authentication'\n                | 'authentication_international'\n                | 'marketing'\n                | 'utility'\n                | 'service'\n                | 'referral_conversion';\n            /**\n             * Type of pricing model used by the business. Current supported value is CBP\n             */\n            pricing_model: 'CBP';\n        };\n\n        /**\n         * The customer's WhatsApp ID. Business can respond to customer using this ID.\n         * This ID may not match the customer's phone number.\n         */\n        recipient_id: string;\n\n        /**\n         * Status of the message:\n         * - delivered: Message has been delivered\n         * - read: Message has been read by the customer\n         * - sent: Message has been sent to the customer\n         */\n        status: 'delivered' | 'read' | 'sent';\n\n        /**\n         * Unix timestamp for the status message\n         */\n        timestamp: string;\n    };\n    /**\n     * The original message data as received from the webhook\n     */\n    originalData: any;\n}\n\n/**\n * Webhook event received from WhatsApp\n */\nexport interface WebhookEvent {\n    /**\n     * The field type of the event\n     */\n    field: string;\n\n    /**\n     * The event data\n     */\n    value: any;\n\n    /**\n     * The timestamp when the event was received\n     */\n    timestamp: number;\n}\n\n/**\n * Message handler function type\n */\nexport type MessageHandler = (message: WebhookMessage) => void | Promise<void>;\n\n/**\n * Message status enum\n */\nexport enum MessageStatus {\n    DELIVERED = 'delivered',\n    READ = 'read',\n    SENT = 'sent',\n}\n","import {\n    FlowActionEnum,\n    FlowDataExchangeRequest,\n    FlowEndpointRequest,\n    FlowErrorNotificationRequest,\n    FlowHealthCheckRequest,\n} from '@features/flow/types';\n\n/**\n * Helper function to check if a value is an object\n * @param value The value to check\n * @returns True if the value is a non-null object\n */\nfunction isObject(value: unknown): value is Record<string, unknown> {\n    return typeof value === 'object' && value !== null;\n}\n\n/**\n * Helper function to check if a value is a string\n * @param value The value to check\n * @returns True if the value is a string\n */\nfunction isString(value: unknown): value is string {\n    return typeof value === 'string';\n}\n\n// Array of allowed action types for data exchange requests\nconst DATA_EXCHANGE_ACTIONS = [FlowActionEnum.DATA_EXCHANGE, FlowActionEnum.INIT, FlowActionEnum.BACK] as const;\n\n// Array of allowed action types for error notification requests\nconst ERROR_ACTIONS = [FlowActionEnum.DATA_EXCHANGE, FlowActionEnum.INIT] as const;\n\n/**\n * Type guard to check if a request is a Data Exchange request\n * Validates the request structure according to the Flow API specifications\n *\n * @param request The Flow endpoint request to check\n * @returns True if the request is a valid Data Exchange request, false otherwise\n */\nexport function isFlowDataExchangeRequest(request: FlowEndpointRequest): request is FlowDataExchangeRequest & {\n    action: (typeof DATA_EXCHANGE_ACTIONS)[number];\n    screen?: string;\n    flow_token: string;\n    data?: Record<string, any>;\n} {\n    // Check for basic required fields\n    if (!('flow_token' in request && isString(request.flow_token) && 'action' in request)) {\n        return false;\n    }\n\n    const { action, version, screen, data } = request;\n\n    // Validate API version\n    const hasValidVersion = version === '3.0';\n\n    // Check if the action is one of the allowed actions for data exchange\n    const hasValidAction = DATA_EXCHANGE_ACTIONS.includes(action as any);\n\n    // Screen is optional, but when present must be a string and not 'SUCCESS'\n    const hasValidScreen = typeof screen === 'undefined' || (isString(screen) && screen !== 'SUCCESS');\n\n    // Data is required except for DATA_EXCHANGE action\n    const hasValidData = action === FlowActionEnum.DATA_EXCHANGE || isObject(data);\n\n    // All conditions must be met for a valid data exchange request\n    return hasValidVersion && hasValidAction && hasValidScreen && hasValidData;\n}\n\n/**\n * Type guard to check if a request is an Error Notification request\n * Validates the request structure according to the Flow API error specifications\n *\n * @param request The Flow endpoint request to check\n * @returns True if the request is a valid Error Notification request, false otherwise\n */\nexport function isFlowErrorRequest(request: FlowEndpointRequest): request is FlowErrorNotificationRequest & {\n    action: (typeof ERROR_ACTIONS)[number];\n    screen: string;\n    flow_token: string;\n    data: {\n        error: string;\n        error_message: string;\n    };\n} {\n    // Check for basic required fields\n    if (!('flow_token' in request && isString(request.flow_token) && 'action' in request)) {\n        return false;\n    }\n\n    const { action, screen, data } = request;\n\n    // Check if the action is one of the allowed actions for error notifications\n    const hasValidAction = ERROR_ACTIONS.includes(action as any);\n\n    // Screen is required for error notifications\n    const hasValidScreen = isString(screen);\n\n    // Validate error data structure\n    const hasValidData =\n        isObject(data) &&\n        'error_key' in data &&\n        isString(data.error) &&\n        'error_message' in data &&\n        isString(data.error_message);\n\n    // All conditions must be met for a valid error notification request\n    return hasValidAction && hasValidScreen && hasValidData;\n}\n\n/**\n * Type guard to check if a request is a Ping (health check) request\n * Simple validation for health check endpoints in the Flow API\n *\n * @param request The Flow endpoint request to check\n * @returns True if the request is a Ping request, false otherwise\n */\nexport function isFlowPingRequest(request: FlowEndpointRequest): request is FlowHealthCheckRequest {\n    // A ping request only requires the 'action' field with value 'ping'\n    return 'action' in request && request.action === 'ping';\n}\n","import { FlowEndpointRequest } from '@features/flow';\nimport { FlowTypeEnum } from '@features/flow/types';\nimport { MessageTypesEnum } from '@shared/types';\nimport { WabaConfigType } from '@shared/types/config';\nimport { isFlowDataExchangeRequest, isFlowErrorRequest, isFlowPingRequest } from '@shared/utils/flowTypeGuards';\nimport Logger from '@shared/utils/logger';\nimport crypto from 'crypto';\nimport { WhatsApp } from '../../whatsapp';\nimport { WebhookMessage, WebhookMessageValue } from '../types';\n\nconst LIB_NAME = 'WEBHOOK_UTILS';\nconst LOGGER = new Logger(LIB_NAME, process.env.DEBUG === 'true');\n\nexport interface WebhookRequest {\n    method: string;\n    query: Record<string, any>;\n    body: any;\n    headers: Record<string, string | string[] | undefined>;\n    rawBody?: string;\n}\n\nexport interface WebhookResponse {\n    statusCode: number;\n    body?: any;\n    headers?: Record<string, string>;\n}\n\nexport type MessageHandler = (whatsapp: WhatsApp, message: WebhookMessage) => void | Promise<void>;\nexport type FlowHandler = (whatsapp: WhatsApp, request: FlowEndpointRequest) => any | Promise<any>;\n\n/**\n * Pure function to handle webhook verification\n */\nexport function verifyWebhook(request: Pick<WebhookRequest, 'query'>, verificationToken: string): WebhookResponse {\n    const mode = request.query['hub.mode'];\n    const token = request.query['hub.verify_token'];\n    const challenge = request.query['hub.challenge'];\n\n    // Check if this is actually a webhook verification request\n    const isWebhookVerificationRequest = mode !== undefined && token !== undefined && challenge !== undefined;\n\n    if (!isWebhookVerificationRequest) {\n        LOGGER.log('Not a webhook verification request - missing required parameters');\n        return {\n            statusCode: 400,\n            body: { error: 'Invalid webhook verification request' },\n        };\n    }\n\n    const VERIFICATION_SUCCESS = mode === 'subscribe' && token === verificationToken;\n\n    if (VERIFICATION_SUCCESS) {\n        LOGGER.log('Webhook verified successfully');\n        return {\n            statusCode: 200,\n            body: challenge,\n        };\n    } else {\n        LOGGER.log('Webhook verification failed');\n        return {\n            statusCode: 403,\n        };\n    }\n}\n\n/**\n * Pure function to process webhook messages\n */\nexport async function processWebhookMessages(\n    request: WebhookRequest,\n    whatsapp: WhatsApp,\n    handlers: {\n        messageHandlers: Map<MessageTypesEnum, MessageHandler>;\n        preProcessHandler?: MessageHandler;\n        postProcessHandler?: MessageHandler;\n    },\n): Promise<WebhookResponse> {\n    const body = request.body;\n    const errors: string[] = [];\n\n    // Check this is a WhatsApp Business Account webhook\n    if (body.object !== 'whatsapp_business_account') {\n        const errorMsg = 'Received webhook for non-WhatsApp event';\n        LOGGER.log(errorMsg);\n        return {\n            statusCode: 404,\n            body: { error: errorMsg },\n        };\n    }\n\n    // Process each entry\n    for (const entry of body.entry) {\n        try {\n            const changes = entry.changes;\n            for (const change of changes) {\n                if (change.field === 'messages') {\n                    await processMessages(entry.id, change.value, whatsapp, handlers);\n                }\n            }\n        } catch (error) {\n            const errorMsg = `Error processing webhook: ${error}`;\n            LOGGER.log(errorMsg);\n            errors.push(errorMsg);\n        }\n    }\n\n    return {\n        statusCode: 200,\n        body: errors.length > 0 ? { errors } : undefined,\n    };\n}\n\n/**\n * Pure function to handle flow requests\n */\nexport async function processFlowRequest(\n    request: WebhookRequest,\n    config: WabaConfigType,\n    whatsapp: WhatsApp,\n    flowHandlers: Map<FlowTypeEnum, FlowHandler>,\n): Promise<WebhookResponse> {\n    try {\n        // Validate request signature\n        if (!isRequestSignatureValid(request, config.WEBHOOK_VERIFICATION_TOKEN || '')) {\n            LOGGER.log('Invalid request signature');\n            return {\n                statusCode: 401,\n                body: { error: 'Unauthorized' },\n            };\n        }\n\n        const body = JSON.parse(request.rawBody || '{}');\n\n        // Decrypt the request\n        const { decryptedBody } = decryptFlowRequest(body, config);\n\n        // Get the flow handler\n        const handler = flowHandlers.get(FlowTypeEnum.All);\n        if (!handler) {\n            LOGGER.log(`No handler registered for flow action: ${decryptedBody.action}`);\n            return {\n                statusCode: 404,\n                body: { error: 'Handler not found' },\n            };\n        }\n\n        // Handle different flow types\n        if (isFlowPingRequest(decryptedBody)) {\n            return {\n                statusCode: 200,\n                body: {\n                    version: '3.0',\n                    data: { status: 'active' },\n                },\n            };\n        }\n\n        if (isFlowErrorRequest(decryptedBody)) {\n            LOGGER.log(`Flow error: ${JSON.stringify(decryptedBody)}`);\n            return {\n                statusCode: 200,\n                body: {},\n            };\n        }\n\n        if (isFlowDataExchangeRequest(decryptedBody)) {\n            const result = await handler(whatsapp, decryptedBody);\n            const encryptedResponse = encryptFlowResponse(\n                result,\n                Buffer.from(body.aes_key, 'base64'),\n                Buffer.from(body.initial_vector, 'base64'),\n            );\n\n            return {\n                statusCode: 200,\n                body: encryptedResponse,\n            };\n        }\n\n        LOGGER.log(`Unknown flow request type: ${JSON.stringify(decryptedBody)}`);\n        return {\n            statusCode: 400,\n            body: { error: 'Unknown request type' },\n        };\n    } catch (error) {\n        LOGGER.log(`Error handling flow request: ${error}`);\n        return {\n            statusCode: 500,\n            body: { error: 'Internal server error' },\n        };\n    }\n}\n\n/**\n * Private helper functions\n */\nasync function processMessages(\n    waba_id: string,\n    value: WebhookMessageValue,\n    whatsapp: WhatsApp,\n    handlers: {\n        messageHandlers: Map<MessageTypesEnum, MessageHandler>;\n        preProcessHandler?: MessageHandler;\n        postProcessHandler?: MessageHandler;\n    },\n): Promise<void> {\n    const metadata = value.metadata;\n    const contacts = value.contacts;\n    const wabaId = waba_id;\n    const displayPhoneNumber = metadata?.display_phone_number || '';\n    const phoneNumberId = metadata?.phone_number_id || '';\n    const profileName = contacts?.[0]?.profile?.name || '';\n\n    if (value.statuses && value.statuses.length > 0) {\n        const statuses = value.statuses;\n        for (const status of statuses) {\n            const processedStatus: WebhookMessage = {\n                wabaId,\n                id: status.id,\n                from: status.recipient_id,\n                timestamp: status.timestamp,\n                type: MessageTypesEnum.Statuses,\n                phoneNumberId,\n                displayPhoneNumber,\n                profileName,\n                statuses: value.statuses[0],\n                originalData: status,\n            };\n\n            await executeHandler(\n                handlers.messageHandlers.get(MessageTypesEnum.Statuses),\n                whatsapp,\n                processedStatus,\n                MessageTypesEnum.Statuses,\n            );\n        }\n        return;\n    }\n\n    if (value.messages && value.messages.length > 0) {\n        const messages = value.messages;\n\n        for (const message of messages) {\n            const messageType = message.type;\n\n            const processedMessage: WebhookMessage = {\n                wabaId,\n                id: message.id,\n                from: message.from,\n                timestamp: message.timestamp,\n                type: message.type,\n                phoneNumberId,\n                displayPhoneNumber,\n                profileName,\n                text: message.text,\n                image: message.image,\n                video: message.video,\n                audio: message.audio,\n                document: message.document,\n                sticker: message.sticker,\n                location: message.location,\n                contacts: message.contacts,\n                interactive: message.interactive,\n                button: message.button,\n                order: message.order,\n                system: message.system,\n                originalData: message,\n            };\n\n            // Execute handlers in sequence\n            await executeHandler(handlers.preProcessHandler, whatsapp, processedMessage, 'pre-process');\n            await executeHandler(handlers.messageHandlers.get(messageType), whatsapp, processedMessage, messageType);\n            await executeHandler(handlers.postProcessHandler, whatsapp, processedMessage, 'post-process');\n        }\n    }\n}\n\nasync function executeHandler(\n    handler: MessageHandler | undefined,\n    whatsapp: WhatsApp,\n    message: WebhookMessage,\n    handlerType: string,\n): Promise<void> {\n    if (handler) {\n        try {\n            await handler(whatsapp, message);\n        } catch (error) {\n            LOGGER.log(`Error in ${handlerType} handler: ${error}`);\n        }\n    }\n}\n\nfunction isRequestSignatureValid(request: WebhookRequest, verificationToken: string): boolean {\n    const signature = request.headers['x-hub-signature-256'] as string;\n    if (!signature || !request.rawBody) {\n        return false;\n    }\n\n    const expectedSignature = crypto\n        .createHmac('sha256', verificationToken)\n        .update(request.rawBody, 'utf8')\n        .digest('hex');\n\n    const formattedExpectedSignature = `sha256=${expectedSignature}`;\n\n    return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(formattedExpectedSignature));\n}\n\nfunction decryptFlowRequest(\n    body: any,\n    config: WabaConfigType,\n): {\n    decryptedBody: FlowEndpointRequest;\n    aesKeyBuffer: Buffer;\n    initialVectorBuffer: Buffer;\n} {\n    const { encrypted_aes_key, encrypted_flow_data, initial_vector } = body;\n\n    if (!encrypted_aes_key || !encrypted_flow_data || !initial_vector) {\n        throw new Error('Missing required encryption properties');\n    }\n\n    const privatePem = config.FLOW_API_PRIVATE_PEM.replace(/\\\\n/g, '\\n');\n    const passphrase = config.FLOW_API_PASSPHRASE;\n\n    const privateKey = crypto.createPrivateKey({ key: privatePem, passphrase });\n    let decryptedAesKey: Buffer;\n\n    try {\n        decryptedAesKey = crypto.privateDecrypt(\n            {\n                key: privateKey,\n                padding: crypto.constants.RSA_PKCS1_OAEP_PADDING,\n                oaepHash: 'sha256',\n            },\n            Buffer.from(encrypted_aes_key, 'base64'),\n        );\n    } catch (error) {\n        throw new Error('Failed to decrypt the request. Please verify your private key.');\n    }\n\n    const flowDataBuffer = Buffer.from(encrypted_flow_data, 'base64');\n    const initialVectorBuffer = Buffer.from(initial_vector, 'base64');\n\n    const TAG_LENGTH = 16;\n    const encrypted_flow_data_body = flowDataBuffer.subarray(0, -TAG_LENGTH);\n    const encrypted_flow_data_tag = flowDataBuffer.subarray(-TAG_LENGTH);\n\n    const decipher = crypto.createDecipheriv('aes-128-gcm', decryptedAesKey, initialVectorBuffer);\n    decipher.setAuthTag(encrypted_flow_data_tag);\n\n    const decryptedJSONString = Buffer.concat([decipher.update(encrypted_flow_data_body), decipher.final()]).toString(\n        'utf-8',\n    );\n\n    return {\n        decryptedBody: JSON.parse(decryptedJSONString),\n        aesKeyBuffer: decryptedAesKey,\n        initialVectorBuffer,\n    };\n}\n\nfunction encryptFlowResponse(response: any, aesKeyBuffer: Buffer, initialVectorBuffer: Buffer): string {\n    const flipped_iv: number[] = [];\n    for (const pair of Array.from(initialVectorBuffer.entries())) {\n        flipped_iv.push(~pair[1]);\n    }\n\n    try {\n        const cipher = crypto.createCipheriv('aes-128-gcm', aesKeyBuffer, Buffer.from(flipped_iv));\n        return Buffer.concat([\n            cipher.update(JSON.stringify(response || {}), 'utf-8'),\n            cipher.final(),\n            cipher.getAuthTag(),\n        ]).toString('base64');\n    } catch (error) {\n        LOGGER.log('Response encryption error:', error);\n        throw new Error('Failed to encrypt response. Internal server error.');\n    }\n}\n","import { FlowTypeEnum } from '@features/flow/types';\nimport { importConfig } from '@shared/config/importConfig';\nimport { MessageTypesEnum } from '@shared/types';\nimport { WabaConfigType, WhatsAppConfig } from '@shared/types/config';\nimport Logger from '@shared/utils/logger';\nimport { WhatsApp } from '../whatsapp';\nimport {\n    FlowHandler,\n    MessageHandler,\n    processFlowRequest,\n    processWebhookMessages,\n    verifyWebhook,\n    WebhookRequest,\n    WebhookResponse,\n} from './utils/webhookUtils';\n\nconst LIB_NAME = 'WEBHOOK';\nconst LOGGER = new Logger(LIB_NAME, process.env.DEBUG === 'true');\n\n/**\n * Framework-agnostic WebhookHandler using pure functions\n */\nexport class WebhookHandler {\n    private config: WabaConfigType;\n    private client: WhatsApp;\n    private messageHandlers: Map<MessageTypesEnum, MessageHandler> = new Map();\n    private preProcessHandler: MessageHandler | undefined = undefined;\n    private postProcessHandler: MessageHandler | undefined = undefined;\n    private flowHandlers: Map<FlowTypeEnum, FlowHandler> = new Map();\n\n    constructor(config: WhatsAppConfig) {\n        this.config = importConfig(config);\n        this.client = new WhatsApp(config);\n        LOGGER.log('WebhookHandler instantiated!');\n    }\n\n    /**\n     * Handle webhook verification (framework-agnostic)\n     */\n    public handleVerification = (request: Pick<WebhookRequest, 'query'>): WebhookResponse => {\n        return verifyWebhook(request, this.config.WEBHOOK_VERIFICATION_TOKEN || '');\n    };\n\n    /**\n     * Handle webhook messages (framework-agnostic)\n     */\n    public handleWebhook = async (request: WebhookRequest): Promise<WebhookResponse> => {\n        return processWebhookMessages(request, this.client, {\n            messageHandlers: this.messageHandlers,\n            preProcessHandler: this.preProcessHandler,\n            postProcessHandler: this.postProcessHandler,\n        });\n    };\n\n    /**\n     * Handle flow requests (framework-agnostic)\n     */\n    public handleFlow = async (request: WebhookRequest): Promise<WebhookResponse> => {\n        return processFlowRequest(request, this.config, this.client, this.flowHandlers);\n    };\n\n    /**\n     * Register a message handler for a specific message type\n     */\n    public onMessage(type: MessageTypesEnum, handler: MessageHandler): void {\n        this.messageHandlers.set(type, handler);\n        LOGGER.log(`Registered message handler for ${type}`);\n    }\n\n    /**\n     * Register a pre-process handler that runs before all message handlers\n     */\n    public onMessagePreProcess(handler: MessageHandler): void {\n        this.preProcessHandler = handler;\n        LOGGER.log('Registered pre-process handler');\n    }\n\n    /**\n     * Register a post-process handler that runs after all message handlers\n     */\n    public onMessagePostProcess(handler: MessageHandler): void {\n        this.postProcessHandler = handler;\n        LOGGER.log('Registered post-process handler');\n    }\n\n    /**\n     * Register a flow handler for a specific flow type\n     */\n    public onFlow(type: FlowTypeEnum, handler: FlowHandler): void {\n        this.flowHandlers.set(type, handler);\n        LOGGER.log(`Registered flow handler for ${type}`);\n    }\n}\n","import * as crypto from 'crypto';\n\nexport const generateXHub256Sig = (body: string, appSecret: string) => {\n    return crypto.createHmac('sha256', appSecret).update(body, 'utf-8').digest('hex');\n};\n"]}