meta-cloud-api 1.1.9 → 1.1.10

package/dist/index.d.ts

@@ -745,171 +745,827 @@ type WabaConfigType = {
   [WabaConfigEnum.Passphrase]: string;
 };
 //#endregion
-//#region src/types/request.d.ts
-type GeneralRequestBody = Record<string, unknown>;
-interface RequesterResponseInterface<T> {
-  json: () => Promise<T>;
-}
-interface ResponseSuccess {
-  success: boolean;
-}
-interface ResponseData<T> {
-  data: T;
-}
-interface ResponsePagination<T> {
-  data: T[];
-  paging: Paging;
-}
-interface Paging {
-  cursors: {
-    before: string;
-    after: string;
-  };
-  next: string;
-}
-declare class RequesterClass {
-  constructor(apiVersion: string, phoneNumberId: number, accessToken: string, businessAcctId: string, userAgent: string);
-  sendRequest: (method: HttpMethodsEnum, path: string, timeout: number, body?: GeneralRequestBody, contentType?: string, additionalHeaders?: Record<string, string>) => Promise<RequesterResponseInterface<unknown>>;
-  getJson<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: GeneralRequestBody, additionalHeaders?: Record<string, string>): Promise<T>;
-  sendFormData<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, formData: FormData, additionalHeaders?: Record<string, string>): Promise<T>;
-  sendUrlEncodedForm<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, formData: Record<string, string>, additionalHeaders?: Record<string, string>): Promise<T>;
-}
-//#endregion
-//#region src/types/httpsClient.d.ts
-type ResponseHeaderValue = string | string[] | undefined;
-type ResponseHeaders = Record<string, ResponseHeaderValue>;
-type ResponseJSONBody = Record<string, unknown>;
-declare class HttpsClientResponseClass {
-  constructor(resp: Response);
-  statusCode: () => number;
-  headers: () => ResponseHeaders;
-  rawResponse: () => Response;
-  json: () => Promise<ResponseJSONBody>;
-}
-declare class HttpsClientClass {
-  constructor();
-  clearSockets: () => boolean;
-  sendRequest: (host: string, path: string, method: HttpMethodsEnum, headers: HeadersInit, timeout: number, body?: BodyInit | null) => Promise<HttpsClientResponseClass>;
-}
-//#endregion
-//#region src/types/base.d.ts
-declare class BaseClass {
-  constructor(config: WabaConfigType);
-}
-declare class BaseAPI implements BaseClass {
-  protected config: WabaConfigType;
-  protected client: RequesterClass;
-  constructor(config: WabaConfigType, client: RequesterClass);
-  protected sendJson<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
-  protected sendFormData<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
-  protected sendUrlEncodedForm<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
-}
-//#endregion
-//#region src/api/profile/types/upload.d.ts
-/**
- * Upload session information for creating upload sessions.
- */
-interface UploadSession {
-  id: string;
-  video?: boolean;
-}
-/**
- * Response from creating an upload session.
- */
-interface UploadSessionResponse {
-  id: string;
-}
-/**
- * Response from uploading business profile media.
- */
-interface UploadBusinessProfileResponse {
-  h: string;
-}
-/**
- * Upload handle information containing file details and handle.
- */
-interface UploadHandle {
-  handle: string;
-  file_size: number;
-  upload_result: {
-    handle_type: string;
-    name: string;
-  };
-}
-/**
- * Request parameters for creating upload session.
- */
-interface CreateUploadSessionParams {
+//#region src/core/webhook/types.d.ts
+interface WebhookContact {
   /**
-   * Length of the file to be uploaded in bytes.
+   * WhatsApp ID of the contact. Business can respond to this contact using this ID.
    */
-  fileLength: number;
+  wa_id: string;
   /**
-   * MIME type of the file (e.g., 'image/jpeg').
+   *  Additional unique, alphanumeric identifier for a WhatsApp user
    */
-  fileType: string;
+  user_id?: string;
   /**
-   * Name of the file with extension.
+   * Profile of Whatsapp user
    */
-  fileName: string;
+  profile: {
+    /**
+     * The display name of the contact
+     */
+    name: string;
+  };
 }
 /**
- * Request parameters for uploading media.
+ * Base message interface with common properties
  */
-interface UploadMediaParams {
+interface BaseMessage {
+  id: string;
+  from: string;
+  timestamp: string;
+  type: MessageTypesEnum;
   /**
-   * The upload session ID from createUploadSession response.
+   * Context object, included when a user replies or interacts
    */
-  uploadId: string;
+  context?: {
+    /**
+     * ID of the message
+     */
+    id?: string;
+    /**
+     * ID of the sender
+     */
+    from?: string;
+    /**
+     * ID of the message being replied to or interacted with
+     */
+    message_id: string;
+    /**
+     * ID of the forwarded message, if applicable
+     */
+    forwarded?: boolean;
+    /**
+     * Frequently forwarded status
+     */
+    frequently_forwarded?: boolean;
+    /**
+     * Original message information if the message was referred
+     */
+    referred_product?: {
+      /**
+       * Catalog ID
+       */
+      catalog_id: string;
+      /**
+       * Product ID
+       */
+      product_retailer_id: string;
+    };
+  };
   /**
-   * The binary data of the file (Buffer).
+   * Errors array, if the message had errors
    */
-  file: Buffer;
+  errors?: Array<{
+    /**
+     * Error code
+     */
+    code: number;
+    /**
+     * Error title
+     */
+    title: string;
+    /**
+     * Error message
+     */
+    message: string;
+    /**
+     * Error details object
+     */
+    error_data?: {
+      /**
+       * Describes the error details
+       */
+      details: string;
+    };
+  }>;
 }
 /**
- * Request parameters for getting upload handle.
+ * Text message interface
  */
-interface GetUploadHandleParams {
-  /**
-   * The upload session ID from createUploadSession response.
-   */
-  uploadId: string;
+interface TextMessage extends BaseMessage {
+  type: MessageTypesEnum.Text;
+  text: {
+    /**
+     * The text content of the message
+     */
+    body: string;
+    preview_url?: boolean;
+  };
 }
-//#endregion
-//#region src/api/profile/types/common.d.ts
 /**
- * Available fields that can be requested when retrieving a business profile.
+ * Image message interface
  */
-type BusinessProfileField = 'about' | 'address' | 'description' | 'email' | 'profile_picture_url' | 'websites' | 'vertical';
-type BusinessProfileFieldsParam = BusinessProfileField[] | string;
+interface ImageMessage extends BaseMessage {
+  type: MessageTypesEnum.Image;
+  image: {
+    /**
+     * The image caption (if provided)
+     */
+    caption?: string;
+    /**
+     * The SHA256 hash of the image
+     */
+    sha256?: string;
+    /**
+     * The ID for the image
+     */
+    id: string;
+    /**
+     * The MIME type of the image
+     */
+    mime_type: string;
+  };
+}
 /**
- * Business profile data structure containing all profile information.
+ * Video message interface
  */
-interface BusinessProfileData {
-  /**
-   * The business's About text. This text appears in the business's profile, beneath its profile image,
-   * phone number, and contact buttons.
-   * - String cannot be empty
-   * - Strings must be between 1 and 139 characters
-   * - Rendered emojis are supported however their unicode values are not.
-   *   Emoji unicode values must be Java- or JavaScript-escape encoded
-   * - Hyperlinks can be included but will not render as clickable links
-   * - Markdown is not supported
-   */
-  about?: string;
-  /**
-   * Address of the business. Character limit 256.
-   */
-  address?: string;
-  /**
-   * Description of the business. Character limit 512.
-   */
-  description?: string;
-  /**
-   * The contact email address (in valid email format) of the business. Character limit 128.
-   */
-  email?: string;
-  /**
+interface VideoMessage extends BaseMessage {
+  type: MessageTypesEnum.Video;
+  video: {
+    /**
+     * The video caption (if provided)
+     */
+    caption?: string;
+    /**
+     * The SHA256 hash of the video
+     */
+    sha256?: string;
+    /**
+     * The ID for the video
+     */
+    id: string;
+    /**
+     * The MIME type of the video
+     */
+    mime_type: string;
+  };
+}
+/**
+ * Audio message interface
+ */
+interface AudioMessage extends BaseMessage {
+  type: MessageTypesEnum.Audio;
+  audio: {
+    /**
+     * The ID for the audio file
+     */
+    id: string;
+    /**
+     * The MIME type of the audio file
+     */
+    mime_type: string;
+    /**
+     * Whether the audio is a voice message
+     */
+    voice?: boolean;
+  };
+}
+/**
+ * Document message interface
+ */
+interface DocumentMessage extends BaseMessage {
+  type: MessageTypesEnum.Document;
+  document: {
+    /**
+     * The document caption (if provided)
+     */
+    caption?: string;
+    /**
+     * The document filename
+     */
+    filename: string;
+    /**
+     * The SHA256 hash of the document
+     */
+    sha256?: string;
+    /**
+     * The ID for the document
+     */
+    id: string;
+    /**
+     * The MIME type of the document
+     */
+    mime_type: string;
+  };
+}
+/**
+ * Sticker message interface
+ */
+interface StickerMessage extends BaseMessage {
+  type: MessageTypesEnum.Sticker;
+  sticker: {
+    /**
+     * The ID for the sticker
+     */
+    id: string;
+    /**
+     * Whether this is an animated sticker
+     */
+    animated: boolean;
+    /**
+     * The MIME type of the sticker
+     */
+    mime_type: string;
+  };
+}
+/**
+ * Reaction message interface
+ */
+interface ReactionMessage extends BaseMessage {
+  type: MessageTypesEnum.Reaction;
+  reaction: {
+    /**
+     * The ID of the message being reacted to
+     */
+    message_id: string;
+    /**
+     * Emoji used for the reaction
+     */
+    emoji: string;
+  };
+}
+/**
+ * Contacts message interface
+ */
+interface ContactsMessage extends BaseMessage {
+  type: MessageTypesEnum.Contacts;
+  contacts: Array<{
+    /**
+     * The contact's name
+     */
+    name: {
+      /**
+       * The formatted name
+       */
+      formatted_name: string;
+      /**
+       * The first name
+       */
+      first_name?: string;
+      /**
+       * The last name
+       */
+      last_name?: string;
+      /**
+       * The middle name
+       */
+      middle_name?: string;
+      /**
+       * The suffix
+       */
+      suffix?: string;
+      /**
+       * The prefix
+       */
+      prefix?: string;
+    };
+    /**
+     * The contact's phone numbers
+     */
+    phones?: Array<{
+      phone: string;
+      type?: string;
+      wa_id?: string;
+    }>;
+    /**
+     * The contact's emails
+     */
+    emails?: Array<{
+      email: string;
+      type?: string;
+    }>;
+    /**
+     * The contact's addresses
+     */
+    addresses?: Array<{
+      street?: string;
+      city?: string;
+      state?: string;
+      zip?: string;
+      country?: string;
+      country_code?: string;
+      type?: string;
+    }>;
+    /**
+     * The contact's organizations
+     */
+    org?: {
+      company?: string;
+      department?: string;
+      title?: string;
+    };
+    /**
+     * The contact's URLs
+     */
+    urls?: Array<{
+      url: string;
+      type?: string;
+    }>;
+    /**
+     * The contact's birthday (YYYY-MM-DD format)
+     */
+    birthday?: string;
+  }>;
+}
+/**
+ * Location message interface
+ */
+interface LocationMessage extends BaseMessage {
+  type: MessageTypesEnum.Location;
+  location: {
+    /**
+     * Latitude of the location
+     */
+    latitude: number;
+    /**
+     * Longitude of the location
+     */
+    longitude: number;
+    /**
+     * Name of the location
+     */
+    name?: string;
+    /**
+     * Address of the location
+     */
+    address?: string;
+  };
+}
+/**
+ * Interactive message interface
+ */
+interface InteractiveMessage extends BaseMessage {
+  type: MessageTypesEnum.Interactive;
+  interactive: {
+    /**
+     * Type of the interactive message
+     * Can be: button_reply, list_reply, flow, nfm_reply, etc.
+     */
+    type: string;
+    /**
+     * ID for the button that was clicked
+     */
+    button_reply?: {
+      id: string;
+      title: string;
+    };
+    /**
+     * ID for the list item that was selected
+     */
+    list_reply?: {
+      id: string;
+      title: string;
+      description?: string;
+    };
+    /**
+     * NFM (No-Code Flow Message) reply data
+     */
+    nfm_reply?: {
+      /**
+       * Response data in JSON format
+       */
+      response_json: string;
+      /**
+       * Body text of the reply
+       */
+      body: string;
+      /**
+       * Name of the flow
+       */
+      name: string;
+    };
+  };
+}
+/**
+ * System message interface
+ */
+interface SystemMessage extends BaseMessage {
+  type: MessageTypesEnum.System;
+  system: {
+    /**
+     * The type of system update
+     */
+    type: string;
+    /**
+     * User's identity if the update is a customer identity change
+     */
+    identity?: string;
+    /**
+     * Old and new phone numbers if the update is a phone number change
+     */
+    customer?: {
+      /**
+       * The previous phone number
+       */
+      previous_wa_id: string;
+      /**
+       * The new phone number
+       */
+      wa_id: string;
+    };
+  };
+}
+/**
+ * Order message interface
+ */
+interface OrderMessage extends BaseMessage {
+  type: MessageTypesEnum.Order;
+  order: {
+    /**
+     * Catalog ID
+     */
+    catalog_id: string;
+    /**
+     * Product items in the order
+     */
+    product_items: Array<{
+      /**
+       * Product ID
+       */
+      product_retailer_id: string;
+      /**
+       * Quantity of the product
+       */
+      quantity: number;
+      /**
+       * Item price
+       */
+      item_price: number;
+      /**
+       * Currency code
+       */
+      currency: string;
+    }>;
+    /**
+     * Text message included with the order
+     */
+    text?: string;
+  };
+}
+/**
+ * Button message interface
+ */
+interface ButtonMessage extends BaseMessage {
+  type: MessageTypesEnum.Button;
+  button: {
+    /**
+     * The payload for the button
+     */
+    payload: string;
+    /**
+     * Button text
+     */
+    text: string;
+  };
+}
+/**
+ * Represents a message received through the webhook
+ * Based on Meta's documentation: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components#messages-object
+ */
+interface WebhookMessage {
+  /**
+   * The WhatsApp Business Account ID
+   */
+  wabaId: string;
+  /**
+   * The message ID
+   */
+  id: string;
+  /**
+   * The sender's phone number
+   */
+  from: string;
+  /**
+   * The timestamp of the message
+   */
+  timestamp: string;
+  /**
+   * The type of message (text, image, etc.)
+   */
+  type: MessageTypesEnum;
+  /**
+   * The phone number ID that received the message
+   */
+  phoneNumberId: string;
+  /**
+   * The display phone number that received the message
+   */
+  displayPhoneNumber: string;
+  /**
+   * The profile name of the sender
+   */
+  profileName: string;
+  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
+     */
+    biz_opaque_callback_data?: string;
+    /**
+     * Information about the conversation
+     */
+    conversation?: {
+      /**
+       * Represents the ID of the conversation the given status notification belongs to
+       */
+      id: string;
+      /**
+       * Describes conversation category
+       */
+      origin: {
+        /**
+         * Indicates conversation category. This can also be referred to as a conversation entry point
+         * - authentication: Conversation opened by business sending template categorized as AUTHENTICATION
+         * - marketing: Conversation opened by business sending template categorized as MARKETING
+         * - utility: Conversation opened by business sending template categorized as UTILITY
+         * - service: Conversation opened by business replying to customer within service window
+         * - referral_conversion: Free entry point conversation
+         */
+        type: 'authentication' | 'marketing' | 'utility' | 'service' | 'referral_conversion';
+      };
+      /**
+       * Date when the conversation expires. Only present for messages with status 'sent'
+       */
+      expiration_timestamp?: string;
+    };
+    /**
+     * Array of error objects describing the error
+     */
+    errors?: Array<{
+      /**
+       * Error code
+       */
+      code: number;
+      /**
+       * Error code title
+       */
+      title: string;
+      /**
+       * Error code message
+       */
+      message: string;
+      /**
+       * Error details object
+       */
+      error_data?: {
+        /**
+         * Describes the error details
+         */
+        details: string;
+      };
+    }>;
+    /**
+     * The ID for the message that the business sent to a customer
+     */
+    id: string;
+    /**
+     * Pricing information for the message/conversation
+     */
+    pricing?: {
+      /**
+       * Indicates if the given message or conversation is billable
+       * @deprecated This field is deprecated. Visit the WhatsApp Changelog for more information.
+       */
+      billable?: boolean;
+      /**
+       * Indicates the conversation category:
+       * - authentication: Authentication conversation
+       * - authentication_international: Authentication-international conversation
+       * - marketing: Marketing conversation
+       * - utility: Utility conversation
+       * - service: Service conversation
+       * - referral_conversion: Free entry point conversation
+       */
+      category: 'authentication' | 'authentication_international' | 'marketing' | 'utility' | 'service' | 'referral_conversion';
+      /**
+       * Type of pricing model used by the business. Current supported value is CBP
+       */
+      pricing_model: 'CBP';
+    };
+    /**
+     * The customer's WhatsApp ID. Business can respond to customer using this ID.
+     * This ID may not match the customer's phone number.
+     */
+    recipient_id: string;
+    /**
+     * Status of the message:
+     * - delivered: Message has been delivered
+     * - read: Message has been read by the customer
+     * - sent: Message has been sent to the customer
+     */
+    status: 'delivered' | 'read' | 'sent';
+    /**
+     * Unix timestamp for the status message
+     */
+    timestamp: string;
+  };
+  /**
+   * The original message data as received from the webhook
+   */
+  originalData: any;
+}
+/**
+ * Webhook event received from WhatsApp
+ */
+interface WebhookEvent {
+  /**
+   * The field type of the event
+   */
+  field: string;
+  /**
+   * The event data
+   */
+  value: any;
+  /**
+   * The timestamp when the event was received
+   */
+  timestamp: number;
+}
+/**
+ * Message status enum
+ */
+declare enum MessageStatus {
+  DELIVERED = "delivered",
+  READ = "read",
+  SENT = "sent",
+}
+//#endregion
+//#region src/types/request.d.ts
+type GeneralRequestBody = Record<string, unknown>;
+interface RequesterResponseInterface<T> {
+  json: () => Promise<T>;
+}
+interface ResponseSuccess {
+  success: boolean;
+}
+interface ResponseData<T> {
+  data: T;
+}
+interface ResponsePagination<T> {
+  data: T[];
+  paging: Paging;
+}
+interface Paging {
+  cursors: {
+    before: string;
+    after: string;
+  };
+  next: string;
+}
+declare class RequesterClass {
+  constructor(apiVersion: string, phoneNumberId: number, accessToken: string, businessAcctId: string, userAgent: string);
+  sendRequest: (method: HttpMethodsEnum, path: string, timeout: number, body?: GeneralRequestBody, contentType?: string, additionalHeaders?: Record<string, string>) => Promise<RequesterResponseInterface<unknown>>;
+  getJson<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: GeneralRequestBody, additionalHeaders?: Record<string, string>): Promise<T>;
+  sendFormData<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, formData: FormData, additionalHeaders?: Record<string, string>): Promise<T>;
+  sendUrlEncodedForm<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, formData: Record<string, string>, additionalHeaders?: Record<string, string>): Promise<T>;
+}
+//#endregion
+//#region src/types/httpsClient.d.ts
+type ResponseHeaderValue = string | string[] | undefined;
+type ResponseHeaders = Record<string, ResponseHeaderValue>;
+type ResponseJSONBody = Record<string, unknown>;
+declare class HttpsClientResponseClass {
+  constructor(resp: Response);
+  statusCode: () => number;
+  headers: () => ResponseHeaders;
+  rawResponse: () => Response;
+  json: () => Promise<ResponseJSONBody>;
+}
+declare class HttpsClientClass {
+  constructor();
+  clearSockets: () => boolean;
+  sendRequest: (host: string, path: string, method: HttpMethodsEnum, headers: HeadersInit, timeout: number, body?: BodyInit | null) => Promise<HttpsClientResponseClass>;
+}
+//#endregion
+//#region src/types/base.d.ts
+declare class BaseClass {
+  constructor(config: WabaConfigType);
+}
+declare class BaseAPI implements BaseClass {
+  protected config: WabaConfigType;
+  protected client: RequesterClass;
+  constructor(config: WabaConfigType, client: RequesterClass);
+  protected sendJson<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
+  protected sendFormData<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
+  protected sendUrlEncodedForm<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
+}
+//#endregion
+//#region src/api/profile/types/upload.d.ts
+/**
+ * Upload session information for creating upload sessions.
+ */
+interface UploadSession {
+  id: string;
+  video?: boolean;
+}
+/**
+ * Response from creating an upload session.
+ */
+interface UploadSessionResponse {
+  id: string;
+}
+/**
+ * Response from uploading business profile media.
+ */
+interface UploadBusinessProfileResponse {
+  h: string;
+}
+/**
+ * Upload handle information containing file details and handle.
+ */
+interface UploadHandle {
+  handle: string;
+  file_size: number;
+  upload_result: {
+    handle_type: string;
+    name: string;
+  };
+}
+/**
+ * Request parameters for creating upload session.
+ */
+interface CreateUploadSessionParams {
+  /**
+   * Length of the file to be uploaded in bytes.
+   */
+  fileLength: number;
+  /**
+   * MIME type of the file (e.g., 'image/jpeg').
+   */
+  fileType: string;
+  /**
+   * Name of the file with extension.
+   */
+  fileName: string;
+}
+/**
+ * Request parameters for uploading media.
+ */
+interface UploadMediaParams {
+  /**
+   * The upload session ID from createUploadSession response.
+   */
+  uploadId: string;
+  /**
+   * The binary data of the file (Buffer).
+   */
+  file: Buffer;
+}
+/**
+ * Request parameters for getting upload handle.
+ */
+interface GetUploadHandleParams {
+  /**
+   * The upload session ID from createUploadSession response.
+   */
+  uploadId: string;
+}
+//#endregion
+//#region src/api/profile/types/common.d.ts
+/**
+ * Available fields that can be requested when retrieving a business profile.
+ */
+type BusinessProfileField = 'about' | 'address' | 'description' | 'email' | 'profile_picture_url' | 'websites' | 'vertical';
+type BusinessProfileFieldsParam = BusinessProfileField[] | string;
+/**
+ * Business profile data structure containing all profile information.
+ */
+interface BusinessProfileData {
+  /**
+   * The business's About text. This text appears in the business's profile, beneath its profile image,
+   * phone number, and contact buttons.
+   * - String cannot be empty
+   * - Strings must be between 1 and 139 characters
+   * - Rendered emojis are supported however their unicode values are not.
+   *   Emoji unicode values must be Java- or JavaScript-escape encoded
+   * - Hyperlinks can be included but will not render as clickable links
+   * - Markdown is not supported
+   */
+  about?: string;
+  /**
+   * Address of the business. Character limit 256.
+   */
+  address?: string;
+  /**
+   * Description of the business. Character limit 512.
+   */
+  description?: string;
+  /**
+   * The contact email address (in valid email format) of the business. Character limit 128.
+   */
+  email?: string;
+  /**
    * The messaging service used for the request. Always set it to "whatsapp" if you are using
    * the WhatsApp Business API.
    */
@@ -1851,1056 +2507,381 @@ declare class MessagesClass extends BaseClass {
   interactiveFlow(params: MessageRequestParams<InteractiveObject & {
     type: InteractiveTypesEnum.Flow;
   }>): Promise<MessagesResponse>;
-  reaction(params: ReactionParams): Promise<MessagesResponse>;
-  markAsRead(params: {
-    messageId: string;
-  }): Promise<MessagesResponse>;
-  showTypingIndicator(params: {
-    messageId: string;
-  }): Promise<MessagesResponse>;
-  status(params: StatusParams): Promise<MessagesResponse>;
-}
-//#endregion
-//#region src/api/media/types/common.d.ts
-type MediaResponse = {
-  id: string;
-  url: string;
-  mime_type: string;
-  sha256: string;
-  file_size: number;
-  messaging_product: 'whatsapp';
-};
-type MediasResponse = {
-  data: MediaResponse[];
-  paging: {
-    cursors: {
-      before: string;
-      after: string;
-    };
-  };
-};
-type UploadMediaResponse = {
-  id: string;
-};
-interface MediaClass {
-  getMediaById(mediaId: string, phone_number_id?: string): Promise<MediaResponse>;
-  uploadMedia(file: File, messagingProduct?: string): Promise<UploadMediaResponse>;
-  deleteMedia(mediaId: string, phone_number_id?: string): Promise<ResponseSuccess>;
-  downloadMedia(mediaUrl: string): Promise<Blob>;
-}
-//#endregion
-//#region src/api/flow/types/common.d.ts
-/**
- * Enum for Flow Status
- */
-declare enum FlowStatusEnum {
-  Draft = "DRAFT",
-  Published = "PUBLISHED",
-  Throttled = "THROTTLED",
-  Blocked = "BLOCKED",
-  Deprecated = "DEPRECATED",
-}
-/**
- * Enum for Flow Categories
- */
-declare enum FlowCategoryEnum {
-  SignUp = "SIGN_UP",
-  SignIn = "SIGN_IN",
-  AppointmentBooking = "APPOINTMENT_BOOKING",
-  LeadGeneration = "LEAD_GENERATION",
-  ContactUs = "CONTACT_US",
-  CustomerSupport = "CUSTOMER_SUPPORT",
-  Survey = "SURVEY",
-  Other = "OTHER",
-}
-declare enum FlowActionEnum {
-  INIT = "INIT",
-  BACK = "BACK",
-  DATA_EXCHANGE = "data_exchange",
-}
-/**
- * Enum for Flow Types in webhook handlers
- * Used to register handlers for specific flow events
- */
-declare enum FlowTypeEnum {
-  /** Health check/ping requests */
-  Ping = "ping",
-  /** Data exchange requests */
-  Change = "data_exchange",
-  /** Error notification requests */
-  Error = "error",
-  /** Match all flow action types */
-  All = "*",
-}
-type FlowType = (typeof FlowTypeEnum)[keyof typeof FlowTypeEnum];
-/**
- * Flow Validation Error Pointer
- */
-interface FlowValidationErrorPointer {
-  line_start: number;
-  line_end: number;
-  column_start: number;
-  column_end: number;
-  path: string;
-}
-/**
- * Flow Validation Error
- */
-interface FlowValidationError {
-  error: string;
-  error_type: string;
-  message: string;
-  line_start: number;
-  line_end: number;
-  column_start: number;
-  column_end: number;
-  pointers: FlowValidationErrorPointer[];
-}
-/**
- * Flow Item
- */
-interface Flow {
-  id: string;
-  name: string;
-  status: FlowStatusEnum;
-  categories: FlowCategoryEnum[];
-  validation_errors: FlowValidationError[];
-}
-/**
- * Pagination Cursors
- */
-interface PaginationCursors {
-  before: string;
-  after: string;
-}
-/**
- * Pagination Object
- */
-interface Pagination {
-  cursors: PaginationCursors;
-}
-/**
- * Flows List Response
- */
-interface FlowsListResponse {
-  data: Flow[];
-  paging: Pagination;
-}
-/**
- * Flow Asset
- */
-interface FlowAsset {
-  name: string;
-  asset_type: string;
-  download_url: string;
-}
-/**
- * Flow Assets Response
- */
-interface FlowAssetsResponse {
-  data: FlowAsset[];
-  paging: Pagination;
-}
-/**
- * Flow Preview
- */
-interface FlowPreview {
-  preview_url: string;
-  expires_at: string;
-}
-/**
- * Flow Preview Response
- */
-interface FlowPreviewResponse {
-  preview: FlowPreview;
-  id: string;
-}
-/**
- * Flow Migration Result
- */
-interface FlowMigrationResult {
-  source_name: string;
-  source_id: string;
-  migrated_id: string;
-}
-/**
- * Flow Migration Failure
- */
-interface FlowMigrationFailure {
-  source_name: string;
-  error_code: string;
-  error_message: string;
-}
-/**
- * Create Flow Response
- */
-interface CreateFlowResponse {
-  id: string;
-  success: boolean;
-  validation_errors?: FlowValidationError[];
-}
-/**
- * Update Flow Response
- */
-interface UpdateFlowResponse {
-  success: boolean;
-  validation_errors?: FlowValidationError[];
-}
-/**
- * Flow Migration Response
- */
-interface FlowMigrationResponse {
-  migrated_flows: FlowMigrationResult[];
-  failed_flows: FlowMigrationFailure[];
-}
-/**
- * Validate Flow JSON Response
- */
-interface ValidateFlowJsonResponse {
-  valid: boolean;
-  success: boolean;
-  validation_errors?: FlowValidationError[];
-}
-/**
- * WhatsApp Flow Endpoint - Encrypted Request Payload
- * Represents the raw encrypted data received from WhatsApp
- */
-
-/**
- * WhatsApp Flow Endpoint - Health Check Response
- * The expected response structure for health check requests
- */
-interface FlowHealthCheckResponse {
-  data: {
-    status: 'active';
+  reaction(params: ReactionParams): Promise<MessagesResponse>;
+  markAsRead(params: {
+    messageId: string;
+  }): Promise<MessagesResponse>;
+  showTypingIndicator(params: {
+    messageId: string;
+  }): Promise<MessagesResponse>;
+  status(params: StatusParams): Promise<MessagesResponse>;
+}
+//#endregion
+//#region src/api/media/types/common.d.ts
+type MediaResponse = {
+  id: string;
+  url: string;
+  mime_type: string;
+  sha256: string;
+  file_size: number;
+  messaging_product: 'whatsapp';
+};
+type MediasResponse = {
+  data: MediaResponse[];
+  paging: {
+    cursors: {
+      before: string;
+      after: string;
+    };
   };
+};
+type UploadMediaResponse = {
+  id: string;
+};
+interface MediaClass {
+  getMediaById(mediaId: string, phone_number_id?: string): Promise<MediaResponse>;
+  uploadMedia(file: File, messagingProduct?: string): Promise<UploadMediaResponse>;
+  deleteMedia(mediaId: string, phone_number_id?: string): Promise<ResponseSuccess>;
+  downloadMedia(mediaUrl: string): Promise<Blob>;
 }
+//#endregion
+//#region src/api/flow/types/common.d.ts
 /**
- * WhatsApp Flow Endpoint - Data Exchange Request
- * Represents the structure of a data exchange request
- */
-
-/**
- * WhatsApp Flow Endpoint - Data Exchange Response
- * The expected response structure for data exchange requests
+ * Enum for Flow Status
  */
-interface FlowDataExchangeResponse {
-  screen?: string;
-  data?: Record<string, any | {
-    error_message?: string;
-  }>;
+declare enum FlowStatusEnum {
+  Draft = "DRAFT",
+  Published = "PUBLISHED",
+  Throttled = "THROTTLED",
+  Blocked = "BLOCKED",
+  Deprecated = "DEPRECATED",
 }
 /**
- * WhatsApp Flow Endpoint - Success Screen Response
- * The expected response structure for success screen requests
+ * Enum for Flow Categories
  */
-interface FlowSuccessScreenResponse {
-  screen: 'SUCCESS';
-  data: {
-    extension_message_response?: {
-      params?: {
-        flow_token: string;
-        [key: string]: string;
-      };
-    };
-  };
+declare enum FlowCategoryEnum {
+  SignUp = "SIGN_UP",
+  SignIn = "SIGN_IN",
+  AppointmentBooking = "APPOINTMENT_BOOKING",
+  LeadGeneration = "LEAD_GENERATION",
+  ContactUs = "CONTACT_US",
+  CustomerSupport = "CUSTOMER_SUPPORT",
+  Survey = "SURVEY",
+  Other = "OTHER",
+}
+declare enum FlowActionEnum {
+  INIT = "INIT",
+  BACK = "BACK",
+  DATA_EXCHANGE = "data_exchange",
 }
 /**
- * WhatsApp Flow Endpoint - Error Notification Request
- * Represents the structure of an error notification request
- */
-
-/**
- * WhatsApp Flow Endpoint - Error Notification Response
- * The expected response structure for error notification requests
+ * Enum for Flow Types in webhook handlers
+ * Used to register handlers for specific flow events
  */
-interface FlowErrorNotificationResponse {
-  acknowledged: boolean;
+declare enum FlowTypeEnum {
+  /** Health check/ping requests */
+  Ping = "ping",
+  /** Data exchange requests */
+  Change = "data_exchange",
+  /** Error notification requests */
+  Error = "error",
+  /** Match all flow action types */
+  All = "*",
 }
+type FlowType = (typeof FlowTypeEnum)[keyof typeof FlowTypeEnum];
 /**
- * WhatsApp Flow Endpoint - Comprehensive Request Object
- * A combined type that includes all possible fields from different request types
- * with all fields being optional for flexibility
+ * Flow Validation Error Pointer
  */
-interface FlowEndpointRequest {
-  version?: '3.0';
-  action?: 'ping' | FlowActionEnum;
-  screen?: string;
-  flow_token?: string;
-  data?: Record<string, any> & {
-    error_key?: string;
-    error_message?: string;
-  };
+interface FlowValidationErrorPointer {
+  line_start: number;
+  line_end: number;
+  column_start: number;
+  column_end: number;
+  path: string;
 }
 /**
- * WhatsApp Flow Endpoint - Response
- * Union type for all possible response types from a Flow endpoint
+ * Flow Validation Error
  */
-type FlowEndpointResponse = FlowHealthCheckResponse | FlowDataExchangeResponse | FlowErrorNotificationResponse | FlowSuccessScreenResponse;
-interface FlowClass {
-  /**
-   * List Flows
-   *
-   * @param wabaId - The WABA ID
-   * @returns Promise with the list of flows
-   */
-  listFlows(wabaId: string): Promise<FlowsListResponse>;
-  /**
-   * Create Flow
-   *
-   * @param wabaId - The WABA ID
-   * @param data - The flow data including name, categories, endpoint_uri, and optional clone_flow_id
-   * @returns Promise with the created flow ID
-   */
-  createFlow(wabaId: string, data: {
-    name: string;
-    categories?: FlowCategoryEnum[];
-    endpoint_uri?: string;
-    clone_flow_id?: string;
-    flow_json?: string;
-    publish?: boolean;
-  }): Promise<CreateFlowResponse>;
-  /**
-   * Get Flow
-   *
-   * @param flowId - The flow ID
-   * @param fields - Optional fields to return
-   * @param dateFormat - Optional date format
-   * @returns Promise with the flow details
-   */
-  getFlow(flowId: string, fields?: string, dateFormat?: string): Promise<Flow | FlowPreviewResponse>;
-  /**
-   * Update Flow Metadata
-   *
-   * @param flowId - The flow ID
-   * @param data - The flow metadata to update
-   * @returns Promise with the success status
-   */
-  updateFlowMetadata(flowId: string, data: {
-    name?: string;
-    categories?: FlowCategoryEnum[];
-    endpoint_uri?: string;
-    application_id?: string;
-  }): Promise<ResponseSuccess>;
-  /**
-   * Delete Flow
-   *
-   * @param flowId - The flow ID
-   * @returns Promise with the success status
-   */
-  deleteFlow(flowId: string): Promise<ResponseSuccess>;
-  /**
-   * List Assets (Get Flow JSON URL)
-   *
-   * @param flowId - The flow ID
-   * @returns Promise with the list of assets
-   */
-  listAssets(flowId: string): Promise<FlowAssetsResponse>;
-  /**
-   * Update Flow JSON
-   *
-   * @param flowId - The flow ID
-   * @param data - The asset data including asset_type, file, and name
-   * @returns Promise with the success status and validation errors
-   */
-  updateFlowJson(flowId: string, data: {
-    file: Blob | Buffer | object;
-    name?: string;
-  }): Promise<UpdateFlowResponse>;
-  /**
-   * Validate Flow JSON by attempting an update without publishing.
-   * This is a convenience method; the API doesn't have a dedicated validation endpoint.
-   *
-   * @param flowId - The ID of the Flow (must exist, can be in DRAFT status).
-   * @param flowJsonData - The Flow JSON content as a Buffer, JSON object, or Blob.
-   * @returns Promise indicating if the JSON is valid and includes validation errors if any.
-   */
-  validateFlowJson(flowId: string, flowJsonData: Blob | Buffer | object): Promise<ValidateFlowJsonResponse>;
-  /**
-   * Publish Flow
-   *
-   * @param flowId - The flow ID
-   * @returns Promise with the success status
-   */
-  publishFlow(flowId: string): Promise<ResponseSuccess>;
-  /**
-   * Deprecate Flow
-   *
-   * @param flowId - The flow ID
-   * @returns Promise with the success status
-   */
-  deprecateFlow(flowId: string): Promise<ResponseSuccess>;
-  /**
-   * Migrate Flows
-   *
-   * @param wabaId - The destination WABA ID
-   * @param data - The migration data including source_waba_id and optional source_flow_names
-   * @returns Promise with migration results
-   */
-  migrateFlows(wabaId: string, data: {
-    source_waba_id: string;
-    source_flow_names?: string[];
-  }): Promise<FlowMigrationResponse>;
-}
-//#endregion
-//#region src/core/webhook/types.d.ts
-interface WebhookContact {
-  /**
-   * WhatsApp ID of the contact. Business can respond to this contact using this ID.
-   */
-  wa_id: string;
-  /**
-   *  Additional unique, alphanumeric identifier for a WhatsApp user
-   */
-  user_id?: string;
-  /**
-   * Profile of Whatsapp user
-   */
-  profile: {
-    /**
-     * The display name of the contact
-     */
-    name: string;
-  };
+interface FlowValidationError {
+  error: string;
+  error_type: string;
+  message: string;
+  line_start: number;
+  line_end: number;
+  column_start: number;
+  column_end: number;
+  pointers: FlowValidationErrorPointer[];
 }
 /**
- * Base message interface with common properties
+ * Flow Item
  */
-interface BaseMessage {
+interface Flow {
   id: string;
-  from: string;
-  timestamp: string;
-  type: MessageTypesEnum;
-  /**
-   * Context object, included when a user replies or interacts
-   */
-  context?: {
-    /**
-     * ID of the message
-     */
-    id?: string;
-    /**
-     * ID of the sender
-     */
-    from?: string;
-    /**
-     * ID of the message being replied to or interacted with
-     */
-    message_id: string;
-    /**
-     * ID of the forwarded message, if applicable
-     */
-    forwarded?: boolean;
-    /**
-     * Frequently forwarded status
-     */
-    frequently_forwarded?: boolean;
-    /**
-     * Original message information if the message was referred
-     */
-    referred_product?: {
-      /**
-       * Catalog ID
-       */
-      catalog_id: string;
-      /**
-       * Product ID
-       */
-      product_retailer_id: string;
-    };
-  };
-  /**
-   * Errors array, if the message had errors
-   */
-  errors?: Array<{
-    /**
-     * Error code
-     */
-    code: number;
-    /**
-     * Error title
-     */
-    title: string;
-    /**
-     * Error message
-     */
-    message: string;
-    /**
-     * Error details object
-     */
-    error_data?: {
-      /**
-       * Describes the error details
-       */
-      details: string;
-    };
-  }>;
+  name: string;
+  status: FlowStatusEnum;
+  categories: FlowCategoryEnum[];
+  validation_errors: FlowValidationError[];
 }
 /**
- * Text message interface
+ * Pagination Cursors
  */
-interface TextMessage extends BaseMessage {
-  type: MessageTypesEnum.Text;
-  text: {
-    /**
-     * The text content of the message
-     */
-    body: string;
-    preview_url?: boolean;
-  };
+interface PaginationCursors {
+  before: string;
+  after: string;
 }
 /**
- * Image message interface
+ * Pagination Object
  */
-interface ImageMessage extends BaseMessage {
-  type: MessageTypesEnum.Image;
-  image: {
-    /**
-     * The image caption (if provided)
-     */
-    caption?: string;
-    /**
-     * The SHA256 hash of the image
-     */
-    sha256?: string;
-    /**
-     * The ID for the image
-     */
-    id: string;
-    /**
-     * The MIME type of the image
-     */
-    mime_type: string;
-  };
+interface Pagination {
+  cursors: PaginationCursors;
 }
 /**
- * Video message interface
+ * Flows List Response
  */
-interface VideoMessage extends BaseMessage {
-  type: MessageTypesEnum.Video;
-  video: {
-    /**
-     * The video caption (if provided)
-     */
-    caption?: string;
-    /**
-     * The SHA256 hash of the video
-     */
-    sha256?: string;
-    /**
-     * The ID for the video
-     */
-    id: string;
-    /**
-     * The MIME type of the video
-     */
-    mime_type: string;
-  };
+interface FlowsListResponse {
+  data: Flow[];
+  paging: Pagination;
 }
 /**
- * Audio message interface
+ * Flow Asset
  */
-interface AudioMessage extends BaseMessage {
-  type: MessageTypesEnum.Audio;
-  audio: {
-    /**
-     * The ID for the audio file
-     */
-    id: string;
-    /**
-     * The MIME type of the audio file
-     */
-    mime_type: string;
-    /**
-     * Whether the audio is a voice message
-     */
-    voice?: boolean;
-  };
+interface FlowAsset {
+  name: string;
+  asset_type: string;
+  download_url: string;
 }
 /**
- * Document message interface
+ * Flow Assets Response
  */
-interface DocumentMessage extends BaseMessage {
-  type: MessageTypesEnum.Document;
-  document: {
-    /**
-     * The document caption (if provided)
-     */
-    caption?: string;
-    /**
-     * The document filename
-     */
-    filename: string;
-    /**
-     * The SHA256 hash of the document
-     */
-    sha256?: string;
-    /**
-     * The ID for the document
-     */
-    id: string;
-    /**
-     * The MIME type of the document
-     */
-    mime_type: string;
-  };
+interface FlowAssetsResponse {
+  data: FlowAsset[];
+  paging: Pagination;
 }
 /**
- * Sticker message interface
+ * Flow Preview
  */
-interface StickerMessage extends BaseMessage {
-  type: MessageTypesEnum.Sticker;
-  sticker: {
-    /**
-     * The ID for the sticker
-     */
-    id: string;
-    /**
-     * Whether this is an animated sticker
-     */
-    animated: boolean;
-    /**
-     * The MIME type of the sticker
-     */
-    mime_type: string;
-  };
+interface FlowPreview {
+  preview_url: string;
+  expires_at: string;
 }
 /**
- * Reaction message interface
+ * Flow Preview Response
  */
-interface ReactionMessage extends BaseMessage {
-  type: MessageTypesEnum.Reaction;
-  reaction: {
-    /**
-     * The ID of the message being reacted to
-     */
-    message_id: string;
-    /**
-     * Emoji used for the reaction
-     */
-    emoji: string;
-  };
+interface FlowPreviewResponse {
+  preview: FlowPreview;
+  id: string;
+}
+/**
+ * Flow Migration Result
+ */
+interface FlowMigrationResult {
+  source_name: string;
+  source_id: string;
+  migrated_id: string;
+}
+/**
+ * Flow Migration Failure
+ */
+interface FlowMigrationFailure {
+  source_name: string;
+  error_code: string;
+  error_message: string;
+}
+/**
+ * Create Flow Response
+ */
+interface CreateFlowResponse {
+  id: string;
+  success: boolean;
+  validation_errors?: FlowValidationError[];
+}
+/**
+ * Update Flow Response
+ */
+interface UpdateFlowResponse {
+  success: boolean;
+  validation_errors?: FlowValidationError[];
 }
 /**
- * Contacts message interface
+ * Flow Migration Response
  */
-interface ContactsMessage extends BaseMessage {
-  type: MessageTypesEnum.Contacts;
-  contacts: Array<{
-    /**
-     * The contact's name
-     */
-    name: {
-      /**
-       * The formatted name
-       */
-      formatted_name: string;
-      /**
-       * The first name
-       */
-      first_name?: string;
-      /**
-       * The last name
-       */
-      last_name?: string;
-      /**
-       * The middle name
-       */
-      middle_name?: string;
-      /**
-       * The suffix
-       */
-      suffix?: string;
-      /**
-       * The prefix
-       */
-      prefix?: string;
-    };
-    /**
-     * The contact's phone numbers
-     */
-    phones?: Array<{
-      phone: string;
-      type?: string;
-      wa_id?: string;
-    }>;
-    /**
-     * The contact's emails
-     */
-    emails?: Array<{
-      email: string;
-      type?: string;
-    }>;
-    /**
-     * The contact's addresses
-     */
-    addresses?: Array<{
-      street?: string;
-      city?: string;
-      state?: string;
-      zip?: string;
-      country?: string;
-      country_code?: string;
-      type?: string;
-    }>;
-    /**
-     * The contact's organizations
-     */
-    org?: {
-      company?: string;
-      department?: string;
-      title?: string;
-    };
-    /**
-     * The contact's URLs
-     */
-    urls?: Array<{
-      url: string;
-      type?: string;
-    }>;
-    /**
-     * The contact's birthday (YYYY-MM-DD format)
-     */
-    birthday?: string;
-  }>;
+interface FlowMigrationResponse {
+  migrated_flows: FlowMigrationResult[];
+  failed_flows: FlowMigrationFailure[];
 }
 /**
- * Location message interface
+ * Validate Flow JSON Response
  */
-interface LocationMessage extends BaseMessage {
-  type: MessageTypesEnum.Location;
-  location: {
-    /**
-     * Latitude of the location
-     */
-    latitude: number;
-    /**
-     * Longitude of the location
-     */
-    longitude: number;
-    /**
-     * Name of the location
-     */
-    name?: string;
-    /**
-     * Address of the location
-     */
-    address?: string;
-  };
+interface ValidateFlowJsonResponse {
+  valid: boolean;
+  success: boolean;
+  validation_errors?: FlowValidationError[];
 }
 /**
- * Interactive message interface
+ * WhatsApp Flow Endpoint - Health Check Response
+ * The expected response structure for health check requests
  */
-interface InteractiveMessage extends BaseMessage {
-  type: MessageTypesEnum.Interactive;
-  interactive: {
-    /**
-     * Type of the interactive message
-     * Can be: button_reply, list_reply, flow, nfm_reply, etc.
-     */
-    type: string;
-    /**
-     * ID for the button that was clicked
-     */
-    button_reply?: {
-      id: string;
-      title: string;
-    };
-    /**
-     * ID for the list item that was selected
-     */
-    list_reply?: {
-      id: string;
-      title: string;
-      description?: string;
-    };
-    /**
-     * NFM (No-Code Flow Message) reply data
-     */
-    nfm_reply?: {
-      /**
-       * Response data in JSON format
-       */
-      response_json: string;
-      /**
-       * Body text of the reply
-       */
-      body: string;
-      /**
-       * Name of the flow
-       */
-      name: string;
-    };
+interface FlowHealthCheckResponse {
+  data: {
+    status: 'active';
   };
 }
 /**
- * System message interface
+ * WhatsApp Flow Endpoint - Data Exchange Response
+ * The expected response structure for data exchange requests
  */
-interface SystemMessage extends BaseMessage {
-  type: MessageTypesEnum.System;
-  system: {
-    /**
-     * The type of system update
-     */
-    type: string;
-    /**
-     * User's identity if the update is a customer identity change
-     */
-    identity?: string;
-    /**
-     * Old and new phone numbers if the update is a phone number change
-     */
-    customer?: {
-      /**
-       * The previous phone number
-       */
-      previous_wa_id: string;
-      /**
-       * The new phone number
-       */
-      wa_id: string;
-    };
-  };
+interface FlowDataExchangeResponse {
+  screen?: string;
+  data?: Record<string, any | {
+    error_message?: string;
+  }>;
 }
 /**
- * Order message interface
+ * WhatsApp Flow Endpoint - Success Screen Response
+ * The expected response structure for success screen requests
  */
-interface OrderMessage extends BaseMessage {
-  type: MessageTypesEnum.Order;
-  order: {
-    /**
-     * Catalog ID
-     */
-    catalog_id: string;
-    /**
-     * Product items in the order
-     */
-    product_items: Array<{
-      /**
-       * Product ID
-       */
-      product_retailer_id: string;
-      /**
-       * Quantity of the product
-       */
-      quantity: number;
-      /**
-       * Item price
-       */
-      item_price: number;
-      /**
-       * Currency code
-       */
-      currency: string;
-    }>;
-    /**
-     * Text message included with the order
-     */
-    text?: string;
+interface FlowSuccessScreenResponse {
+  screen: 'SUCCESS';
+  data: {
+    extension_message_response?: {
+      params?: {
+        flow_token: string;
+        [key: string]: string;
+      };
+    };
   };
 }
 /**
- * Button message interface
+ * WhatsApp Flow Endpoint - Error Notification Response
+ * The expected response structure for error notification requests
  */
-interface ButtonMessage extends BaseMessage {
-  type: MessageTypesEnum.Button;
-  button: {
-    /**
-     * The payload for the button
-     */
-    payload: string;
-    /**
-     * Button text
-     */
-    text: string;
+interface FlowErrorNotificationResponse {
+  acknowledged: boolean;
+}
+/**
+ * WhatsApp Flow Endpoint - Comprehensive Request Object
+ * A combined type that includes all possible fields from different request types
+ * with all fields being optional for flexibility
+ */
+interface FlowEndpointRequest {
+  version?: '3.0';
+  action?: 'ping' | FlowActionEnum;
+  screen?: string;
+  flow_token?: string;
+  data?: Record<string, any> & {
+    error_key?: string;
+    error_message?: string;
   };
 }
 /**
- * Union type for all message types
- */
-
-/**
- * Represents a message received through the webhook
- * Based on Meta's documentation: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components#messages-object
+ * WhatsApp Flow Endpoint - Response
+ * Union type for all possible response types from a Flow endpoint
  */
-interface WebhookMessage {
-  /**
-   * The WhatsApp Business Account ID
-   */
-  wabaId: string;
+type FlowEndpointResponse = FlowHealthCheckResponse | FlowDataExchangeResponse | FlowErrorNotificationResponse | FlowSuccessScreenResponse;
+interface FlowClass {
   /**
-   * The message ID
+   * List Flows
+   *
+   * @param wabaId - The WABA ID
+   * @returns Promise with the list of flows
    */
-  id: string;
+  listFlows(wabaId: string): Promise<FlowsListResponse>;
   /**
-   * The sender's phone number
+   * Create Flow
+   *
+   * @param wabaId - The WABA ID
+   * @param data - The flow data including name, categories, endpoint_uri, and optional clone_flow_id
+   * @returns Promise with the created flow ID
    */
-  from: string;
+  createFlow(wabaId: string, data: {
+    name: string;
+    categories?: FlowCategoryEnum[];
+    endpoint_uri?: string;
+    clone_flow_id?: string;
+    flow_json?: string;
+    publish?: boolean;
+  }): Promise<CreateFlowResponse>;
   /**
-   * The timestamp of the message
+   * Get Flow
+   *
+   * @param flowId - The flow ID
+   * @param fields - Optional fields to return
+   * @param dateFormat - Optional date format
+   * @returns Promise with the flow details
    */
-  timestamp: string;
+  getFlow(flowId: string, fields?: string, dateFormat?: string): Promise<Flow | FlowPreviewResponse>;
   /**
-   * The type of message (text, image, etc.)
+   * Update Flow Metadata
+   *
+   * @param flowId - The flow ID
+   * @param data - The flow metadata to update
+   * @returns Promise with the success status
    */
-  type: MessageTypesEnum;
+  updateFlowMetadata(flowId: string, data: {
+    name?: string;
+    categories?: FlowCategoryEnum[];
+    endpoint_uri?: string;
+    application_id?: string;
+  }): Promise<ResponseSuccess>;
   /**
-   * The phone number ID that received the message
+   * Delete Flow
+   *
+   * @param flowId - The flow ID
+   * @returns Promise with the success status
    */
-  phoneNumberId: string;
+  deleteFlow(flowId: string): Promise<ResponseSuccess>;
   /**
-   * The display phone number that received the message
+   * List Assets (Get Flow JSON URL)
+   *
+   * @param flowId - The flow ID
+   * @returns Promise with the list of assets
    */
-  displayPhoneNumber: string;
+  listAssets(flowId: string): Promise<FlowAssetsResponse>;
   /**
-   * The profile name of the sender
+   * Update Flow JSON
+   *
+   * @param flowId - The flow ID
+   * @param data - The asset data including asset_type, file, and name
+   * @returns Promise with the success status and validation errors
    */
-  profileName: string;
-  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
-     */
-    biz_opaque_callback_data?: string;
-    /**
-     * Information about the conversation
-     */
-    conversation?: {
-      /**
-       * Represents the ID of the conversation the given status notification belongs to
-       */
-      id: string;
-      /**
-       * Describes conversation category
-       */
-      origin: {
-        /**
-         * Indicates conversation category. This can also be referred to as a conversation entry point
-         * - authentication: Conversation opened by business sending template categorized as AUTHENTICATION
-         * - marketing: Conversation opened by business sending template categorized as MARKETING
-         * - utility: Conversation opened by business sending template categorized as UTILITY
-         * - service: Conversation opened by business replying to customer within service window
-         * - referral_conversion: Free entry point conversation
-         */
-        type: 'authentication' | 'marketing' | 'utility' | 'service' | 'referral_conversion';
-      };
-      /**
-       * Date when the conversation expires. Only present for messages with status 'sent'
-       */
-      expiration_timestamp?: string;
-    };
-    /**
-     * Array of error objects describing the error
-     */
-    errors?: Array<{
-      /**
-       * Error code
-       */
-      code: number;
-      /**
-       * Error code title
-       */
-      title: string;
-      /**
-       * Error code message
-       */
-      message: string;
-      /**
-       * Error details object
-       */
-      error_data?: {
-        /**
-         * Describes the error details
-         */
-        details: string;
-      };
-    }>;
-    /**
-     * The ID for the message that the business sent to a customer
-     */
-    id: string;
-    /**
-     * Pricing information for the message/conversation
-     */
-    pricing?: {
-      /**
-       * Indicates if the given message or conversation is billable
-       * @deprecated This field is deprecated. Visit the WhatsApp Changelog for more information.
-       */
-      billable?: boolean;
-      /**
-       * Indicates the conversation category:
-       * - authentication: Authentication conversation
-       * - authentication_international: Authentication-international conversation
-       * - marketing: Marketing conversation
-       * - utility: Utility conversation
-       * - service: Service conversation
-       * - referral_conversion: Free entry point conversation
-       */
-      category: 'authentication' | 'authentication_international' | 'marketing' | 'utility' | 'service' | 'referral_conversion';
-      /**
-       * Type of pricing model used by the business. Current supported value is CBP
-       */
-      pricing_model: 'CBP';
-    };
-    /**
-     * The customer's WhatsApp ID. Business can respond to customer using this ID.
-     * This ID may not match the customer's phone number.
-     */
-    recipient_id: string;
-    /**
-     * Status of the message:
-     * - delivered: Message has been delivered
-     * - read: Message has been read by the customer
-     * - sent: Message has been sent to the customer
-     */
-    status: 'delivered' | 'read' | 'sent';
-    /**
-     * Unix timestamp for the status message
-     */
-    timestamp: string;
-  };
+  updateFlowJson(flowId: string, data: {
+    file: Blob | Buffer | object;
+    name?: string;
+  }): Promise<UpdateFlowResponse>;
   /**
-   * The original message data as received from the webhook
+   * Validate Flow JSON by attempting an update without publishing.
+   * This is a convenience method; the API doesn't have a dedicated validation endpoint.
+   *
+   * @param flowId - The ID of the Flow (must exist, can be in DRAFT status).
+   * @param flowJsonData - The Flow JSON content as a Buffer, JSON object, or Blob.
+   * @returns Promise indicating if the JSON is valid and includes validation errors if any.
    */
-  originalData: any;
-}
-/**
- * Webhook event received from WhatsApp
- */
-interface WebhookEvent {
+  validateFlowJson(flowId: string, flowJsonData: Blob | Buffer | object): Promise<ValidateFlowJsonResponse>;
   /**
-   * The field type of the event
+   * Publish Flow
+   *
+   * @param flowId - The flow ID
+   * @returns Promise with the success status
    */
-  field: string;
+  publishFlow(flowId: string): Promise<ResponseSuccess>;
   /**
-   * The event data
+   * Deprecate Flow
+   *
+   * @param flowId - The flow ID
+   * @returns Promise with the success status
    */
-  value: any;
+  deprecateFlow(flowId: string): Promise<ResponseSuccess>;
   /**
-   * The timestamp when the event was received
+   * Migrate Flows
+   *
+   * @param wabaId - The destination WABA ID
+   * @param data - The migration data including source_waba_id and optional source_flow_names
+   * @returns Promise with migration results
    */
-  timestamp: number;
-}
-/**
- * Message status enum
- */
-declare enum MessageStatus {
-  DELIVERED = "delivered",
-  READ = "read",
-  SENT = "sent",
+  migrateFlows(wabaId: string, data: {
+    source_waba_id: string;
+    source_flow_names?: string[];
+  }): Promise<FlowMigrationResponse>;
 }
 //#endregion
 //#region src/api/qrCode/types/common.d.ts