meta-cloud-api 1.3.0 → 1.4.0

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-import { AudioMediaTypesEnum, BusinessVerticalEnum, ButtonPositionEnum, CategoryEnum, ComponentTypesEnum, ConversationTypesEnum, CurrencyCodesEnum, DataLocalizationRegionEnum, DocumentMediaTypesEnum, HttpMethodsEnum, ImageMediaTypesEnum, InteractiveTypesEnum, LanguagesEnum, MessageTypesEnum, ParametersTypesEnum, ReferralSourceTypesEnum, RequestCodeMethodsEnum, StatusEnum, StickerMediaTypesEnum, SubTypeEnum, SystemChangeTypesEnum, TemplateStatusEnum, VideoMediaTypesEnum, WabaConfigEnum, WebhookTypesEnum } from "./enums-mxRGX-JN.js";
+import { AudioMediaTypesEnum, BusinessVerticalEnum, ButtonPositionEnum, CategoryEnum, ComponentTypesEnum, ConversationTypesEnum, CurrencyCodesEnum, DataLocalizationRegionEnum, DocumentMediaTypesEnum, HttpMethodsEnum, ImageMediaTypesEnum, InteractiveTypesEnum, LanguagesEnum, MessageTypesEnum, ParametersTypesEnum, ReferralSourceTypesEnum, RequestCodeMethodsEnum, StatusEnum, StickerMediaTypesEnum, SubTypeEnum, SystemChangeTypesEnum, TemplateStatusEnum, VideoMediaTypesEnum, WabaConfigEnum, WebhookTypesEnum } from "./enums-Dx5yD3dt.js";
 import { IncomingHttpHeaders, IncomingMessage } from "http";
 
 //#region src/types/config.d.ts
@@ -126,6 +126,17 @@ interface Paging {
   };
   next: string;
 }
+/**
+ * Common error detail structure used in Meta API responses
+ * Used for individual item errors in bulk operations
+ */
+interface MetaErrorDetail {
+  message: string;
+  code: string;
+  error_data?: {
+    details: 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>>;
@@ -394,11 +405,49 @@ type VerifyCodeRequest = {
 type TwoStepVerificationParams = {
   pin: string;
 };
+/**
+ * Conversational Components - Commands
+ */
+type ConversationalCommand = {
+  command_name: string;
+  command_description: string;
+};
+/**
+ * Conversational Components - Ice Breakers (Prompts)
+ */
+type ConversationalPrompt = string;
+/**
+ * Request payload for configuring conversational automation
+ */
+type ConversationalAutomationRequest = {
+  enable_welcome_message?: boolean;
+  commands?: ConversationalCommand[];
+  prompts?: ConversationalPrompt[];
+};
+/**
+ * Response from conversational automation GET endpoint
+ */
+type ConversationalAutomationResponse = {
+  enable_welcome_message?: boolean;
+  commands?: ConversationalCommand[];
+  prompts?: ConversationalPrompt[];
+  id: string;
+};
+/**
+ * Response from throughput GET endpoint
+ */
+type ThroughputResponse = {
+  throughput: Throughput;
+  id: string;
+};
 interface PhoneNumberClass {
   getPhoneNumberById(fields?: string): Promise<PhoneNumberResponse>;
   getPhoneNumbers(): Promise<PhoneNumbersResponse>;
   requestVerificationCode(params: RequestVerificationCodeRequest): Promise<ResponseSuccess>;
   verifyCode(params: VerifyCodeRequest): Promise<ResponseSuccess>;
+  setConversationalAutomation(params: ConversationalAutomationRequest): Promise<ResponseSuccess>;
+  getConversationalAutomation(): Promise<ConversationalAutomationResponse>;
+  getThroughput(): Promise<ThroughputResponse>;
 }
 //#endregion
 //#region src/api/template/types/common.d.ts
@@ -1195,513 +1244,348 @@ interface MediaClass {
 }
 //#endregion
 //#region src/core/webhook/types.d.ts
+/**
+ * WhatsApp contact information
+ */
 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;
   };
+  identity_key_hash?: string;
 }
 /**
- * Base message interface with common properties
+ * Metadata included in all webhooks
  */
-interface BaseMessage {
-  id: string;
+interface WebhookMetadata {
+  display_phone_number: string;
+  phone_number_id: string;
+}
+/**
+ * Error object structure
+ */
+interface WebhookError {
+  code: number;
+  title: string;
+  message: string;
+  error_data?: {
+    details: string;
+  };
+  href?: string;
+}
+/**
+ * Click to WhatsApp ad referral information
+ */
+interface ReferralInfo {
+  source_url: string;
+  source_id: string;
+  source_type: 'ad';
+  body?: string;
+  headline?: string;
+  media_type?: 'image' | 'video';
+  image_url?: string;
+  video_url?: string;
+  thumbnail_url?: string;
+  ctwa_clid?: string;
+  welcome_message?: {
+    text: string;
+  };
+}
+/**
+ * Context for forwarded messages
+ */
+interface ForwardedContext {
+  forwarded?: true;
+  frequently_forwarded?: true;
+}
+/**
+ * Context for product inquiry messages
+ */
+interface ProductContext {
   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;
-    };
+  id: string;
+  referred_product: {
+    catalog_id: string;
+    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;
-    };
-  }>;
 }
 /**
- * Text message interface
+ * Context for interactive/button replies
+ */
+interface ReplyContext {
+  from: string;
+  id: string;
+}
+/**
+ * Base message properties common to all message types
  */
+interface BaseMessage {
+  from: string;
+  id: string;
+  timestamp: string;
+}
 interface TextMessage extends BaseMessage {
   type: MessageTypesEnum.Text;
   text: {
-    /**
-     * The text content of the message
-     */
     body: string;
-    preview_url?: boolean;
   };
+  context?: ForwardedContext | ProductContext;
+  referral?: ReferralInfo;
 }
-/**
- * Image message interface
- */
 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;
+    sha256: string;
+    id: string;
+    url: string;
   };
+  context?: ForwardedContext;
+  referral?: ReferralInfo;
 }
-/**
- * Video message interface
- */
 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;
+    sha256: string;
+    id: string;
+    url: string;
   };
+  context?: ForwardedContext;
+  referral?: ReferralInfo;
 }
-/**
- * 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;
+    sha256: string;
+    id: string;
+    url: string;
+    voice: boolean;
   };
+  referral?: ReferralInfo;
 }
-/**
- * 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;
+    sha256: string;
+    id: string;
+    url: string;
   };
+  referral?: ReferralInfo;
 }
-/**
- * Sticker message interface
- */
 interface StickerMessage extends BaseMessage {
   type: MessageTypesEnum.Sticker;
   sticker: {
-    /**
-     * The ID for the sticker
-     */
+    mime_type: string;
+    sha256: string;
     id: string;
-    /**
-     * Whether this is an animated sticker
-     */
+    url: string;
     animated: boolean;
-    /**
-     * The MIME type of the sticker
-     */
-    mime_type: string;
   };
+  referral?: ReferralInfo;
 }
-/**
- * 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;
+interface InteractiveListReplyMessage extends BaseMessage {
+  type: MessageTypesEnum.Interactive;
+  context: ReplyContext;
+  interactive: {
+    type: 'list_reply';
+    list_reply: {
+      id: string;
+      title: string;
+      description?: string;
+    };
   };
 }
-/**
- * Contacts message interface
- */
+interface InteractiveButtonReplyMessage extends BaseMessage {
+  type: MessageTypesEnum.Interactive;
+  context: ReplyContext;
+  interactive: {
+    type: 'button_reply';
+    button_reply: {
+      id: string;
+      title: string;
+    };
+  };
+}
+type InteractiveMessage = InteractiveListReplyMessage | InteractiveButtonReplyMessage;
+interface ButtonMessage extends BaseMessage {
+  type: MessageTypesEnum.Button;
+  context: ReplyContext;
+  button: {
+    payload: string;
+    text: string;
+  };
+}
+interface LocationMessage extends BaseMessage {
+  type: MessageTypesEnum.Location;
+  location: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    address?: string;
+    url?: string;
+  };
+  referral?: ReferralInfo;
+}
 interface ContactsMessage extends BaseMessage {
   type: MessageTypesEnum.Contacts;
   contacts: Array<{
-    /**
-     * The contact's name
-     */
+    addresses?: Array<{
+      city?: string;
+      country?: string;
+      country_code?: string;
+      state?: string;
+      street?: string;
+      type?: string;
+      zip?: string;
+    }>;
+    birthday?: string;
+    emails?: Array<{
+      email: string;
+      type?: string;
+    }>;
     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
-     */
+    phones?: Array<{
+      phone: string;
+      wa_id?: string;
+      type?: string;
+    }>;
     urls?: Array<{
       url: string;
       type?: string;
     }>;
-    /**
-     * The contact's birthday (YYYY-MM-DD format)
-     */
-    birthday?: string;
   }>;
+  referral?: ReferralInfo;
 }
-/**
- * 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;
-    };
+interface ReactionMessage extends BaseMessage {
+  type: MessageTypesEnum.Reaction;
+  reaction: {
+    message_id: string;
+    emoji?: string;
   };
 }
-/**
- * Order message interface
- */
 interface OrderMessage extends BaseMessage {
   type: MessageTypesEnum.Order;
   order: {
-    /**
-     * Catalog ID
-     */
     catalog_id: string;
-    /**
-     * Product items in the order
-     */
+    text?: string;
     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 SystemMessage extends BaseMessage {
+  type: MessageTypesEnum.System;
+  system: {
+    body: string;
+    wa_id: string;
+    type: 'user_changed_number';
+  };
+}
+interface UnsupportedMessage extends BaseMessage {
+  type: MessageTypesEnum.Unsupported;
+  errors: Array<WebhookError>;
+}
+type GroupMessage = {
+  group_id: string;
+} & (TextMessage | ImageMessage | VideoMessage | AudioMessage | DocumentMessage | LocationMessage | ContactsMessage);
+type WhatsAppMessage = TextMessage | ImageMessage | VideoMessage | AudioMessage | DocumentMessage | StickerMessage | InteractiveMessage | ButtonMessage | LocationMessage | ContactsMessage | ReactionMessage | OrderMessage | SystemMessage | UnsupportedMessage | GroupMessage;
+interface StatusWebhook {
+  id: string;
+  status: 'sent' | 'delivered' | 'read' | 'failed';
+  timestamp: string;
+  recipient_id: string;
+  recipient_type?: 'group';
+  recipient_participant_id?: string;
+  recipient_identity_key_hash?: string;
+  biz_opaque_callback_data?: string;
+  conversation?: {
+    id: string;
+    expiration_timestamp?: string;
+    origin: {
+      type: 'authentication' | 'authentication_international' | 'marketing' | 'marketing_lite' | 'referral_conversion' | 'service' | 'utility';
+    };
+  };
+  pricing?: {
+    billable: boolean;
+    pricing_model: 'CBP' | 'PMP';
+    type: 'regular' | 'free_customer_service' | 'free_entry_point';
+    category: 'authentication' | 'authentication_international' | 'marketing' | 'marketing_lite' | 'referral_conversion' | 'service' | 'utility';
+  };
+  errors?: Array<WebhookError>;
+}
 /**
- * Button message interface
+ * Webhook value for incoming messages
  */
-interface ButtonMessage extends BaseMessage {
-  type: MessageTypesEnum.Button;
-  button: {
-    /**
-     * The payload for the button
-     */
-    payload: string;
-    /**
-     * Button text
-     */
-    text: string;
-  };
+interface MessageWebhookValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  contacts: Array<WebhookContact>;
+  messages: Array<WhatsAppMessage>;
 }
 /**
+ * Webhook value for status updates
+ */
+interface StatusWebhookValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  statuses: Array<StatusWebhook>;
+}
+/**
+ * Webhook value for errors (no contacts or messages)
+ */
+interface ErrorWebhookValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  errors: Array<WebhookError>;
+}
+/**
+ * Union type for all webhook value types
+ */
+type WebhookValue = MessageWebhookValue | StatusWebhookValue | ErrorWebhookValue;
+interface WebhookPayload {
+  object: 'whatsapp_business_account';
+  entry: Array<{
+    id: string;
+    changes: Array<{
+      value: WebhookValue;
+      field: 'messages';
+    }>;
+  }>;
+}
+/**
+ * @deprecated Use specific message types instead
  * 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'];
@@ -1716,129 +1600,15 @@ interface WebhookMessage {
   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
-   */
+  statuses?: StatusWebhook;
   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;
 }
 //#endregion
@@ -2423,5 +2193,90 @@ interface FlowClass {
   }): Promise<FlowMigrationResponse>;
 }
 //#endregion
-export { type AccountMode, type AudioMediaObject, AudioMediaTypesEnum, type AuthenticationTemplateOptions, type BaseClass, type BodyOptions, type BusinessProfileClass, type BusinessProfileData, type BusinessProfileField, type BusinessProfileFieldsParam, type BusinessProfileResponse, BusinessVerticalEnum, type ButtonOptions, ButtonPositionEnum, type CarouselCard, type CarouselOptions, type CatalogButton, type CatalogTemplateOptions, CategoryEnum, type CodeVerificationStatus, type ComponentTypes, ComponentTypesEnum, type ContactObject, ConversationTypesEnum, type CopyCodeButton, type CouponTemplateOptions, CreateFlowResponse, type CreateQrCodeRequest, CurrencyCodesEnum, type CurrencyParameter, type Cursors, DataLocalizationRegionEnum, type DateTimeParameter, type DocumentMediaObject, DocumentMediaTypesEnum, type EncryptionPublicKeyResponse, type Flow, FlowActionEnum, type FlowAsset, type FlowAssetsResponse, type FlowButton, FlowCategoryEnum, type FlowClass, type FlowDataExchangeRequest, type FlowDataExchangeResponse, type FlowDecryptedRequestResponse, type FlowEncryptedRequestPayload, type FlowEndpointRequest, type FlowEndpointResponse, type FlowErrorNotificationRequest, type FlowErrorNotificationResponse, type FlowHealthCheckRequest, type FlowHealthCheckResponse, type FlowHttpRequest, type FlowMigrationFailure, type FlowMigrationResponse, type FlowMigrationResult, type FlowPreview, type FlowPreviewResponse, FlowStatusEnum, type FlowSuccessScreenResponse, type FlowType, FlowTypeEnum, type FlowValidationError, type FlowValidationErrorPointer, type FlowsListResponse, type FooterOptions, type GeneralHeaderInterface, type GeneralMessageBody, type GeneralRequestBody, type HeaderOptions, type HealthStatus, type HealthStatusEntity, HttpMethodsEnum, type HttpsClientClass, type HttpsClientResponseClass, type ImageMediaObject, ImageMediaTypesEnum, type InteractiveObject, InteractiveTypesEnum, LanguagesEnum, type LimitedTimeOfferOptions, type LimitedTimeOfferTemplateOptions, type LocationObject, type LocationParameter, type LoggerInterface, type MPMButton, type MPMTemplateOptions, type MediaCardCarouselTemplateOptions, type MediaCarouselCard, MediaClass, type MediaParameter, MediaResponse, MediasResponse, type MessageRequestBody, type MessageRequestParams, type MessageTemplateObject, MessageTypesEnum, type MessagesClass, type MessagesResponse, type MessagingLimitTier, type MetaError, type OTPButton, type OTPTemplateOptions, type Pagination, type PaginationCursors, type Paging, ParametersTypesEnum, type PhoneNumberButton, type PhoneNumberClass, type PhoneNumberResponse, type PhoneNumbersResponse, type PlatformType, type ProductCardCarouselTemplateOptions, type ProductCarouselCard, type ProductParameter, type ProductSection, type QrCodeClass, type QrCodeResponse, type QrCodesResponse, type QualityRating, type QualityScore, type QuickReplyButton, type ReactionParams, ReferralSourceTypesEnum, type RegistrationClass, type RegistrationRequest, RequestCodeMethodsEnum, type RequestVerificationCodeRequest, type RequesterClass, type RequesterResponseInterface, type ResponseData, type ResponseHeaderValue, type ResponseHeaders, type ResponseJSONBody, type ResponsePagination, type ResponseSuccess, type SPMButton, type SPMTemplateOptions, StatusEnum, type StatusParams, type StickerMediaObject, StickerMediaTypesEnum, SubTypeEnum, SystemChangeTypesEnum, type TemplateBody, type TemplateButton, type TemplateButtons, type TemplateCarousel, type TemplateClass, type TemplateDeleteParams, type TemplateFooter, type TemplateFormat, type TemplateGetParams, type TemplateHeader, type TemplateHeaderExample, type TemplateLimitedTimeOffer, type TemplateOptions, type TemplateParameter, type TemplateRequestBody, type TemplateResponse, TemplateStatusEnum, type TextMessageParams, type TextObject, type TextParameter, type Throughput, type ThroughputLevel, type TwoStepVerificationClass, type TwoStepVerificationParams, type TwoStepVerificationRequest, type URLButton, type UpdateBusinessProfileRequest, type UpdateFlowResponse, type UpdateQrCodeRequest, type UpdateWabaSubscription, UploadMediaResponse, type ValidateFlowJsonResponse, type VerifyCodeRequest, type VideoMediaObject, VideoMediaTypesEnum, type WABAClass, type WabaAccount, type WabaAccountFields, type WabaAccountFieldsParam, WabaAccountReviewStatus, WabaAccountStatus, WabaBusinessVerificationStatus, WabaConfigEnum, type WabaConfigType, type WabaHealthStatus, WabaHealthStatusCanSendMessage, type WabaHealthStatusEntity, type WabaHealthStatusError, type WabaSubscription, type WabaSubscriptions, type WebhookContact, type WebhookEvent, type WebhookMessage, WebhookTypesEnum, type WhatsAppConfig };
+//#region src/api/blockUsers/types/blockUsers.d.ts
+/**
+ * Blocked user information in response
+ */
+type BlockedUserInfo = {
+  input: string;
+  wa_id: string;
+};
+/**
+ * Failed user information with error details
+ * Uses common MetaErrorDetail type for consistency across APIs
+ */
+type FailedUserInfo = BlockedUserInfo & {
+  errors?: MetaErrorDetail[];
+};
+/**
+ * Response for block/unblock operations
+ */
+type BlockUsersResponse = {
+  messaging_product: 'whatsapp';
+  block_users: {
+    added_users?: BlockedUserInfo[];
+    failed_users?: FailedUserInfo[];
+  };
+};
+/**
+ * Pagination cursors for list operations
+ */
+type PagingCursors = {
+  after?: string;
+  before?: string;
+};
+/**
+ * Pagination information
+ */
+type PagingInfo = {
+  cursors?: PagingCursors;
+  previous?: string;
+  next?: string;
+};
+/**
+ * List blocked users response
+ */
+type ListBlockedUsersResponse = {
+  data: Array<{
+    block_users: BlockedUserInfo[];
+  }>;
+  paging?: PagingInfo;
+};
+/**
+ * Query parameters for listing blocked users
+ */
+type ListBlockedUsersParams = {
+  limit?: number;
+  after?: string;
+  before?: string;
+};
+/**
+ * Block Users API Interface
+ */
+interface BlockUsersClass {
+  /**
+   * Block one or more WhatsApp users
+   * @param users - Array of phone numbers or WhatsApp IDs to block
+   * @returns Response with successfully blocked and failed users
+   * @throws Error if users have not messaged in last 24 hours
+   * @see https://developers.facebook.com/docs/whatsapp/cloud-api/block-users#block-users
+   */
+  block(users: string[]): Promise<BlockUsersResponse>;
+  /**
+   * Unblock one or more WhatsApp users
+   * @param users - Array of phone numbers or WhatsApp IDs to unblock
+   * @returns Response with successfully unblocked and failed users
+   * @see https://developers.facebook.com/docs/whatsapp/cloud-api/block-users#unblock-users
+   */
+  unblock(users: string[]): Promise<BlockUsersResponse>;
+  /**
+   * Get list of blocked WhatsApp users with pagination
+   * @param params - Optional pagination parameters
+   * @returns List of blocked users with pagination info
+   * @see https://developers.facebook.com/docs/whatsapp/cloud-api/block-users#get-list-of-blocked-numbers
+   */
+  listBlockedUsers(params?: ListBlockedUsersParams): Promise<ListBlockedUsersResponse>;
+}
+//#endregion
+export { type AccountMode, type AudioMediaObject, AudioMediaTypesEnum, type AudioMessage, type AuthenticationTemplateOptions, type BaseClass, type BlockUsersClass, type BlockUsersResponse, type BlockedUserInfo, type BodyOptions, type BusinessProfileClass, type BusinessProfileData, type BusinessProfileField, type BusinessProfileFieldsParam, type BusinessProfileResponse, BusinessVerticalEnum, type ButtonMessage, type ButtonOptions, ButtonPositionEnum, type CarouselCard, type CarouselOptions, type CatalogButton, type CatalogTemplateOptions, CategoryEnum, type CodeVerificationStatus, type ComponentTypes, ComponentTypesEnum, type ContactObject, type ContactsMessage, ConversationTypesEnum, type CopyCodeButton, type CouponTemplateOptions, CreateFlowResponse, type CreateQrCodeRequest, CurrencyCodesEnum, type CurrencyParameter, type Cursors, DataLocalizationRegionEnum, type DateTimeParameter, type DocumentMediaObject, DocumentMediaTypesEnum, type DocumentMessage, type EncryptionPublicKeyResponse, type ErrorWebhookValue, type FailedUserInfo, type Flow, FlowActionEnum, type FlowAsset, type FlowAssetsResponse, type FlowButton, FlowCategoryEnum, type FlowClass, type FlowDataExchangeRequest, type FlowDataExchangeResponse, type FlowDecryptedRequestResponse, type FlowEncryptedRequestPayload, type FlowEndpointRequest, type FlowEndpointResponse, type FlowErrorNotificationRequest, type FlowErrorNotificationResponse, type FlowHealthCheckRequest, type FlowHealthCheckResponse, type FlowHttpRequest, type FlowMigrationFailure, type FlowMigrationResponse, type FlowMigrationResult, type FlowPreview, type FlowPreviewResponse, FlowStatusEnum, type FlowSuccessScreenResponse, type FlowType, FlowTypeEnum, type FlowValidationError, type FlowValidationErrorPointer, type FlowsListResponse, type FooterOptions, type GeneralHeaderInterface, type GeneralMessageBody, type GeneralRequestBody, type GroupMessage, type HeaderOptions, type HealthStatus, type HealthStatusEntity, HttpMethodsEnum, type HttpsClientClass, type HttpsClientResponseClass, type ImageMediaObject, ImageMediaTypesEnum, type ImageMessage, type InteractiveButtonReplyMessage, type InteractiveListReplyMessage, type InteractiveMessage, type InteractiveObject, InteractiveTypesEnum, LanguagesEnum, type LimitedTimeOfferOptions, type LimitedTimeOfferTemplateOptions, type ListBlockedUsersParams, type ListBlockedUsersResponse, type LocationMessage, type LocationObject, type LocationParameter, type LoggerInterface, type MPMButton, type MPMTemplateOptions, type MediaCardCarouselTemplateOptions, type MediaCarouselCard, MediaClass, type MediaParameter, MediaResponse, MediasResponse, type MessageRequestBody, type MessageRequestParams, type MessageTemplateObject, MessageTypesEnum, type MessageWebhookValue, type MessagesClass, type MessagesResponse, type MessagingLimitTier, type MetaError, type MetaErrorDetail, type OTPButton, type OTPTemplateOptions, type OrderMessage, type Pagination, type PaginationCursors, type Paging, ParametersTypesEnum, type PhoneNumberButton, type PhoneNumberClass, type PhoneNumberResponse, type PhoneNumbersResponse, type PlatformType, type ProductCardCarouselTemplateOptions, type ProductCarouselCard, type ProductParameter, type ProductSection, type QrCodeClass, type QrCodeResponse, type QrCodesResponse, type QualityRating, type QualityScore, type QuickReplyButton, type ReactionMessage, type ReactionParams, ReferralSourceTypesEnum, type RegistrationClass, type RegistrationRequest, RequestCodeMethodsEnum, type RequestVerificationCodeRequest, type RequesterClass, type RequesterResponseInterface, type ResponseData, type ResponseHeaderValue, type ResponseHeaders, type ResponseJSONBody, type ResponsePagination, type ResponseSuccess, type SPMButton, type SPMTemplateOptions, StatusEnum, type StatusParams, type StatusWebhook, type StatusWebhookValue, type StickerMediaObject, StickerMediaTypesEnum, type StickerMessage, SubTypeEnum, SystemChangeTypesEnum, type SystemMessage, type TemplateBody, type TemplateButton, type TemplateButtons, type TemplateCarousel, type TemplateClass, type TemplateDeleteParams, type TemplateFooter, type TemplateFormat, type TemplateGetParams, type TemplateHeader, type TemplateHeaderExample, type TemplateLimitedTimeOffer, type TemplateOptions, type TemplateParameter, type TemplateRequestBody, type TemplateResponse, TemplateStatusEnum, type TextMessage, type TextMessageParams, type TextObject, type TextParameter, type Throughput, type ThroughputLevel, type TwoStepVerificationClass, type TwoStepVerificationParams, type TwoStepVerificationRequest, type URLButton, type UnsupportedMessage, type UpdateBusinessProfileRequest, type UpdateFlowResponse, type UpdateQrCodeRequest, type UpdateWabaSubscription, UploadMediaResponse, type ValidateFlowJsonResponse, type VerifyCodeRequest, type VideoMediaObject, VideoMediaTypesEnum, type VideoMessage, type WABAClass, type WabaAccount, type WabaAccountFields, type WabaAccountFieldsParam, WabaAccountReviewStatus, WabaAccountStatus, WabaBusinessVerificationStatus, WabaConfigEnum, type WabaConfigType, type WabaHealthStatus, WabaHealthStatusCanSendMessage, type WabaHealthStatusEntity, type WabaHealthStatusError, type WabaSubscription, type WabaSubscriptions, type WebhookContact, type WebhookEvent, type WebhookMessage, type WebhookPayload, WebhookTypesEnum, type WebhookValue, type WhatsAppConfig, type WhatsAppMessage };
 //# sourceMappingURL=index.d.ts.map