meta-cloud-api 1.4.0 → 1.4.1

package/dist/index.d.ts

@@ -38,6 +38,9 @@ declare enum MessageTypesEnum {
   System = "system",
   Unsupported = "unsupported",
   Unknown = "unknown",
+  /**
+   * @deprecated Use WebhookProcessor.onStatus() instead of onMessage(MessageTypesEnum.Statuses)
+   */
   Statuses = "statuses",
   '*' = "*",
 }
@@ -806,50 +809,6 @@ declare class RequesterClass {
   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/utils/http/httpsClient.d.ts
-declare class HttpsClient implements HttpsClientClass {
-  agent: Agent;
-  constructor();
-  clearSockets(): boolean;
-  sendRequest(hostname: string, path: string, method: HttpMethodsEnum, headers: HeadersInit, timeout: number, body?: BodyInit | null): Promise<HttpsClientResponseClass>;
-}
-//#endregion
-//#region src/utils/http/request.d.ts
-declare class Requester implements RequesterClass {
-  client: Readonly<HttpsClient>;
-  accessToken: Readonly<string>;
-  phoneNumberId: Readonly<number>;
-  businessAcctId: Readonly<string>;
-  apiVersion: Readonly<string>;
-  userAgent: Readonly<string>;
-  host: Readonly<string>;
-  protocol: Readonly<string>;
-  constructor(apiVersion: string, phoneNumberId: number, accessToken: string, businessAcctId: string, userAgent: string);
-  buildHeader(contentType: string, additionalHeaders?: Record<string, string>): HeadersInit;
-  buildCAPIPath(endpoint: string): string;
-  sendRequest(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any, contentType?: string, additionalHeaders?: Record<string, string>): Promise<HttpsClientResponseClass>;
-  getJson<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any, 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/base.d.ts
 declare class BaseClass {
   constructor(config: WabaConfigType);
@@ -863,216 +822,6 @@ declare class BaseAPI implements BaseClass {
   protected sendUrlEncodedForm<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
 }
 //#endregion
-//#region src/api/blockUsers/types/blockUsers.d.ts
-/**
- * Block Users API Types
- * @see https://developers.facebook.com/docs/whatsapp/cloud-api/block-users
- */
-/**
- * User object for blocking/unblocking operations
- */
-type BlockUserObject = {
-  user: string;
-};
-/**
- * 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[];
-};
-/**
- * Request body for blocking users
- */
-type BlockUsersRequest = {
-  messaging_product: 'whatsapp';
-  block_users: BlockUserObject[];
-};
-/**
- * Request body for unblocking users
- */
-type UnblockUsersRequest = {
-  messaging_product: 'whatsapp';
-  block_users: BlockUserObject[];
-};
-/**
- * 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
-//#region src/api/blockUsers/BlockUsersApi.d.ts
-/**
- * Block Users API
- * @see https://developers.facebook.com/docs/whatsapp/cloud-api/block-users
- *
- * Limitations:
- * - Can only block users that have messaged your business in the last 24 hours
- * - 64k blocklist limit
- */
-declare class BlockUsersApi extends BaseAPI implements BlockUsersClass {
-  private readonly endpoint;
-  constructor(config: WabaConfigType, client: RequesterClass);
-  /**
-   * Build request body for block/unblock operations
-   */
-  private buildBlockUsersBody;
-  /**
-   * 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
-   *
-   * @example
-   * ```typescript
-   * // Block single user
-   * const result = await client.blockUsers.block(['1234567890']);
-   *
-   * // Block multiple users
-   * const result = await client.blockUsers.block(['1234567890', '0987654321']);
-   *
-   * // Check results
-   * console.log('Blocked:', result.block_users.added_users);
-   * console.log('Failed:', result.block_users.failed_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
-   *
-   * @example
-   * ```typescript
-   * // Unblock single user
-   * const result = await client.blockUsers.unblock(['1234567890']);
-   *
-   * // Unblock multiple users
-   * const result = await client.blockUsers.unblock(['1234567890', '0987654321']);
-   *
-   * // Check results
-   * console.log('Unblocked:', result.block_users.added_users);
-   * console.log('Failed:', result.block_users.failed_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
-   *
-   * @example
-   * ```typescript
-   * // Get first 10 blocked users
-   * const result = await client.blockUsers.listBlockedUsers({ limit: 10 });
-   *
-   * // Pagination with cursor
-   * const nextPage = await client.blockUsers.listBlockedUsers({
-   *   limit: 10,
-   *   after: result.paging?.cursors?.after
-   * });
-   *
-   * // Get all blocked users
-   * const allBlocked = await client.blockUsers.listBlockedUsers();
-   * ```
-   */
-  listBlockedUsers(params?: ListBlockedUsersParams): Promise<ListBlockedUsersResponse>;
-}
-//#endregion
-//#region src/api/encryption/types/publicKey.d.ts
-type EncryptionPublicKeyResponse = ResponseData<{
-  business_public_key: string;
-  business_public_key_signature_status: 'VALID' | 'MISMATCH';
-}>;
-//#endregion
-//#region src/api/encryption/types/common.d.ts
-interface EncryptionClass {
-  getEncryptionPublicKey(): Promise<EncryptionPublicKeyResponse>;
-  setEncryptionPublicKey(businessPublicKey: string): Promise<ResponseSuccess>;
-}
-//#endregion
-//#region src/api/encryption/EncryptionApi.d.ts
-declare class EncryptionApi extends BaseAPI implements EncryptionClass {
-  private readonly endpoint;
-  constructor(config: WabaConfigType, client: RequesterClass);
-  getEncryptionPublicKey(): Promise<EncryptionPublicKeyResponse>;
-  setEncryptionPublicKey(businessPublicKey: string): Promise<ResponseSuccess>;
-}
-//#endregion
 //#region src/core/webhook/types.d.ts
 /**
  * WhatsApp contact information
@@ -1460,6 +1209,23 @@ interface LoggerInterface {
   debug(...data: any[]): void;
 }
 //#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/api/profile/types/upload.d.ts
 /**
  * Upload session information for creating upload sessions.
@@ -2710,36 +2476,157 @@ interface WabaAccount {
  */
 type WabaAccountFields = 'id' | 'name' | 'account_review_status' | 'auth_international_rate_eligibility' | 'business_verification_status' | 'country' | 'currency' | 'health_status' | 'status' | 'ownership_type' | 'message_template_namespace';
 /**
- * Parameter type for specifying which WABA account fields to retrieve
+ * Parameter type for specifying which WABA account fields to retrieve
+ */
+type WabaAccountFieldsParam = WabaAccountFields[];
+/**
+ * Interface defining all WABA API methods
+ */
+interface WABAClass {
+  getWabaAccount(fields?: WabaAccountFieldsParam): Promise<WabaAccount>;
+  getAllWabaSubscriptions(): Promise<WabaSubscriptions>;
+  updateWabaSubscription(params: UpdateWabaSubscription): Promise<ResponseSuccess>;
+  unsubscribeFromWaba(): Promise<ResponseSuccess>;
+}
+//#endregion
+//#region src/api/registration/types/common.d.ts
+type RegistrationRequest = {
+  messaging_product: 'whatsapp';
+  pin: string;
+  data_localization_region?: DataLocalizationRegionEnum;
+};
+interface RegistrationClass {
+  register(pin: string, dataLocalizationRegion?: DataLocalizationRegionEnum): Promise<ResponseSuccess>;
+  deregister(): Promise<ResponseSuccess>;
+}
+//#endregion
+//#region src/api/twoStepVerification/types/common.d.ts
+type TwoStepVerificationRequest = {
+  pin: string;
+};
+interface TwoStepVerificationClass {
+  setTwoStepVerificationCode(pin: string): Promise<ResponseSuccess>;
+}
+//#endregion
+//#region src/api/encryption/types/publicKey.d.ts
+type EncryptionPublicKeyResponse = ResponseData<{
+  business_public_key: string;
+  business_public_key_signature_status: 'VALID' | 'MISMATCH';
+}>;
+//#endregion
+//#region src/api/encryption/types/common.d.ts
+interface EncryptionClass {
+  getEncryptionPublicKey(): Promise<EncryptionPublicKeyResponse>;
+  setEncryptionPublicKey(businessPublicKey: string): Promise<ResponseSuccess>;
+}
+//#endregion
+//#region src/api/blockUsers/types/blockUsers.d.ts
+/**
+ * Block Users API Types
+ * @see https://developers.facebook.com/docs/whatsapp/cloud-api/block-users
+ */
+/**
+ * User object for blocking/unblocking operations
+ */
+type BlockUserObject = {
+  user: string;
+};
+/**
+ * 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[];
+};
+/**
+ * Request body for blocking users
+ */
+type BlockUsersRequest = {
+  messaging_product: 'whatsapp';
+  block_users: BlockUserObject[];
+};
+/**
+ * Request body for unblocking users
+ */
+type UnblockUsersRequest = {
+  messaging_product: 'whatsapp';
+  block_users: BlockUserObject[];
+};
+/**
+ * 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 WabaAccountFieldsParam = WabaAccountFields[];
+type ListBlockedUsersParams = {
+  limit?: number;
+  after?: string;
+  before?: string;
+};
 /**
- * Interface defining all WABA API methods
+ * Block Users API Interface
  */
-interface WABAClass {
-  getWabaAccount(fields?: WabaAccountFieldsParam): Promise<WabaAccount>;
-  getAllWabaSubscriptions(): Promise<WabaSubscriptions>;
-  updateWabaSubscription(params: UpdateWabaSubscription): Promise<ResponseSuccess>;
-  unsubscribeFromWaba(): Promise<ResponseSuccess>;
-}
-//#endregion
-//#region src/api/registration/types/common.d.ts
-type RegistrationRequest = {
-  messaging_product: 'whatsapp';
-  pin: string;
-  data_localization_region?: DataLocalizationRegionEnum;
-};
-interface RegistrationClass {
-  register(pin: string, dataLocalizationRegion?: DataLocalizationRegionEnum): Promise<ResponseSuccess>;
-  deregister(): Promise<ResponseSuccess>;
-}
-//#endregion
-//#region src/api/twoStepVerification/types/common.d.ts
-type TwoStepVerificationRequest = {
-  pin: string;
-};
-interface TwoStepVerificationClass {
-  setTwoStepVerificationCode(pin: string): Promise<ResponseSuccess>;
+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
 //#region src/utils/isMetaError.d.ts
@@ -2756,6 +2643,12 @@ interface MetaError extends Error {
     fbtrace_id: string;
   };
 }
+/**
+ * Determines if the error is a Meta API error response
+ * @param error Any error object to check
+ * @returns Type guard indicating if error is a Meta API error
+ */
+declare function isMetaError(error: any): error is MetaError;
 //#endregion
 //#region src/api/flow/types/common.d.ts
 /**
@@ -3288,6 +3181,164 @@ declare class FlowApi extends BaseAPI implements FlowClass {
   }): Promise<FlowMigrationResponse>;
 }
 //#endregion
+//#region src/utils/flowEncryptionUtils.d.ts
+/**
+ * Environment model for encryption keys
+ */
+type EncryptionKeyPair = {
+  passphrase: string;
+  privateKey: string;
+  publicKey: string;
+};
+/**
+ * Generates RSA key pair for WhatsApp Business Flow API encryption
+ *
+ * This function generates a 2048-bit RSA key pair with:
+ * - Public key in SPKI format (PEM)
+ * - Private key in PKCS#8 format (PEM) encrypted with AES-256-CBC
+ *
+ * @param passphrase - Passphrase to encrypt the private key. If not provided, uses FLOW_API_PASSPHRASE from environment
+ * @returns Object containing passphrase, privateKey, and publicKey
+ * @throws {Error} If passphrase is empty or key generation fails
+ * @throws {Error} If not running in Node.js environment
+ *
+ * @example
+ * ```typescript
+ * import { WhatsApp } from 'meta-cloud-api';
+ *
+ * const wa = new WhatsApp();
+ *
+ * try {
+ *   // Uses FLOW_API_PASSPHRASE from environment
+ *   const keys = wa.generateEncryption();
+ *   console.log('Public Key:', keys.publicKey);
+ *   console.log('Private Key:', keys.privateKey);
+ *
+ *   // Or provide custom passphrase
+ *   const customKeys = wa.generateEncryption('my-secret-passphrase');
+ * } catch (error) {
+ *   console.error('Failed to generate keys:', error.message);
+ * }
+ * ```
+ */
+declare function generateEncryption(passphrase?: string): EncryptionKeyPair;
+//#endregion
+//#region src/utils/http/httpsClient.d.ts
+declare class HttpsClient implements HttpsClientClass {
+  agent: Agent;
+  constructor();
+  clearSockets(): boolean;
+  sendRequest(hostname: string, path: string, method: HttpMethodsEnum, headers: HeadersInit, timeout: number, body?: BodyInit | null): Promise<HttpsClientResponseClass>;
+}
+//#endregion
+//#region src/utils/http/request.d.ts
+declare class Requester implements RequesterClass {
+  client: Readonly<HttpsClient>;
+  accessToken: Readonly<string>;
+  phoneNumberId: Readonly<number>;
+  businessAcctId: Readonly<string>;
+  apiVersion: Readonly<string>;
+  userAgent: Readonly<string>;
+  host: Readonly<string>;
+  protocol: Readonly<string>;
+  constructor(apiVersion: string, phoneNumberId: number, accessToken: string, businessAcctId: string, userAgent: string);
+  buildHeader(contentType: string, additionalHeaders?: Record<string, string>): HeadersInit;
+  buildCAPIPath(endpoint: string): string;
+  sendRequest(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any, contentType?: string, additionalHeaders?: Record<string, string>): Promise<HttpsClientResponseClass>;
+  getJson<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any, 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/api/blockUsers/BlockUsersApi.d.ts
+/**
+ * Block Users API
+ * @see https://developers.facebook.com/docs/whatsapp/cloud-api/block-users
+ *
+ * Limitations:
+ * - Can only block users that have messaged your business in the last 24 hours
+ * - 64k blocklist limit
+ */
+declare class BlockUsersApi extends BaseAPI implements BlockUsersClass {
+  private readonly endpoint;
+  constructor(config: WabaConfigType, client: RequesterClass);
+  /**
+   * Build request body for block/unblock operations
+   */
+  private buildBlockUsersBody;
+  /**
+   * 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
+   *
+   * @example
+   * ```typescript
+   * // Block single user
+   * const result = await client.blockUsers.block(['1234567890']);
+   *
+   * // Block multiple users
+   * const result = await client.blockUsers.block(['1234567890', '0987654321']);
+   *
+   * // Check results
+   * console.log('Blocked:', result.block_users.added_users);
+   * console.log('Failed:', result.block_users.failed_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
+   *
+   * @example
+   * ```typescript
+   * // Unblock single user
+   * const result = await client.blockUsers.unblock(['1234567890']);
+   *
+   * // Unblock multiple users
+   * const result = await client.blockUsers.unblock(['1234567890', '0987654321']);
+   *
+   * // Check results
+   * console.log('Unblocked:', result.block_users.added_users);
+   * console.log('Failed:', result.block_users.failed_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
+   *
+   * @example
+   * ```typescript
+   * // Get first 10 blocked users
+   * const result = await client.blockUsers.listBlockedUsers({ limit: 10 });
+   *
+   * // Pagination with cursor
+   * const nextPage = await client.blockUsers.listBlockedUsers({
+   *   limit: 10,
+   *   after: result.paging?.cursors?.after
+   * });
+   *
+   * // Get all blocked users
+   * const allBlocked = await client.blockUsers.listBlockedUsers();
+   * ```
+   */
+  listBlockedUsers(params?: ListBlockedUsersParams): Promise<ListBlockedUsersResponse>;
+}
+//#endregion
+//#region src/api/encryption/EncryptionApi.d.ts
+declare class EncryptionApi extends BaseAPI implements EncryptionClass {
+  private readonly endpoint;
+  constructor(config: WabaConfigType, client: RequesterClass);
+  getEncryptionPublicKey(): Promise<EncryptionPublicKeyResponse>;
+  setEncryptionPublicKey(businessPublicKey: string): Promise<ResponseSuccess>;
+}
+//#endregion
 //#region src/api/media/MediaApi.d.ts
 /**
  * API for managing WhatsApp Media.
@@ -4020,38 +4071,69 @@ declare class WhatsApp {
    * Get User-Agent string
    */
   getUserAgent(): string;
+  /**
+   * Generate RSA encryption key pair for WhatsApp Business Flow API
+   *
+   * This method generates a 2048-bit RSA key pair with:
+   * - Public key in SPKI format (PEM)
+   * - Private key in PKCS#8 format (PEM) encrypted with AES-256-CBC
+   *
+   * @param passphrase - Optional passphrase to encrypt the private key. If not provided, uses FLOW_API_PASSPHRASE from config
+   * @returns Object containing passphrase, privateKey, and publicKey
+   * @throws {Error} If passphrase is empty or key generation fails
+   * @throws {Error} If not running in Node.js environment
+   *
+   * @see https://developers.facebook.com/docs/whatsapp/cloud-api/reference/whatsapp-business-encryption/
+   *
+   * @example
+   * ```typescript
+   * const wa = new WhatsApp();
+   *
+   * // Uses FLOW_API_PASSPHRASE from environment/config
+   * const keys = wa.generateEncryption();
+   *
+   * // Or provide custom passphrase
+   * const customKeys = wa.generateEncryption('my-secret-passphrase');
+   *
+   * console.log('Public Key:', keys.publicKey);
+   * console.log('Private Key:', keys.privateKey);
+   * ```
+   */
+  generateEncryption(passphrase?: string): EncryptionKeyPair;
 }
 //#endregion
 //#region src/core/webhook/utils/webhookUtils.d.ts
-type MessageHandler = (whatsapp: WhatsApp, message: WebhookMessage) => void | Promise<void>;
+/**
+ * Processed message with metadata for handlers
+ */
+type ProcessedMessage = {
+  wabaId: string;
+  phoneNumberId: string;
+  displayPhoneNumber: string;
+  profileName: string;
+  message: WhatsAppMessage;
+};
+/**
+ * Processed status with metadata for handlers
+ */
+type ProcessedStatus = {
+  wabaId: string;
+  phoneNumberId: string;
+  displayPhoneNumber: string;
+  status: StatusWebhook;
+};
+type MessageHandler = (whatsapp: WhatsApp, processed: ProcessedMessage) => void | Promise<void>;
+type StatusHandler = (whatsapp: WhatsApp, processed: ProcessedStatus) => void | Promise<void>;
 type FlowHandler = (whatsapp: WhatsApp, request: FlowEndpointRequest) => any | Promise<any>;
 /**
  * Process webhook messages
  */
 declare function processWebhookMessages(request: Request, whatsapp: WhatsApp, handlers: {
   messageHandlers: Map<MessageTypesEnum, MessageHandler>;
+  statusHandler?: StatusHandler;
   preProcessHandler?: MessageHandler;
   postProcessHandler?: MessageHandler;
 }): Promise<Response>;
-/**
- * Create a standard ping response for WhatsApp Flow health checks
- * @returns Flow ping response object
- */
-declare function createFlowPingResponse(): {
-  version: string;
-  data: {
-    status: string;
-  };
-};
-/**
- * Create a standard error response for WhatsApp Flow error notifications
- * @returns Acknowledgement response for error notification
- */
-declare function createFlowErrorResponse(): {
-  data: {
-    acknowledged: boolean;
-  };
-};
 /**
  * Handle flow requests
  */
@@ -4074,6 +4156,7 @@ declare class WebhookProcessor {
   private config;
   private client;
   private messageHandlers;
+  private statusHandler;
   private preProcessHandler;
   private postProcessHandler;
   private flowHandlers;
@@ -4082,6 +4165,7 @@ declare class WebhookProcessor {
   processWebhook(request: Request): Promise<WebhookResponse>;
   processFlow(request: Request): Promise<WebhookResponse>;
   onMessage(type: MessageTypesEnum, handler: MessageHandler): void;
+  onStatus(handler: StatusHandler): void;
   onMessagePreProcess(handler: MessageHandler): void;
   onMessagePostProcess(handler: MessageHandler): void;
   onFlow(type: FlowTypeEnum, handler: FlowHandler): void;
@@ -4183,5 +4267,73 @@ declare function nextjsAppWebhookHandler(config: NextJsAppWebhookConfig): {
 //#region src/core/webhook/utils/generateXHub256Sig.d.ts
 declare const generateXHub256Sig: (body: string, appSecret: string) => string;
 //#endregion
-export { AccountMode, AudioMediaObject, AudioMediaTypesEnum, AudioMessage, AuthenticationTemplateOptions, BaseClass, BlockUserObject, BlockUsersApi, BlockUsersClass, BlockUsersRequest, BlockUsersResponse, BlockedUserInfo, BodyOptions, BusinessProfileApi, BusinessProfileClass, BusinessProfileData, BusinessProfileField, BusinessProfileFieldsParam, BusinessProfileResponse, BusinessVerticalEnum, ButtonMessage, ButtonOptions, ButtonPositionEnum, CarouselCard, CarouselOptions, CatalogButton, CatalogTemplateOptions, CategoryEnum, CodeVerificationStatus, ComponentTypes, ComponentTypesEnum, ContactObject, ContactsMessage, ConversationTypesEnum, CopyCodeButton, CouponTemplateOptions, CreateFlowResponse, CreateQrCodeRequest, CreateUploadSessionParams, CurrencyCodesEnum, CurrencyParameter, Cursors, DataLocalizationRegionEnum, DateTimeParameter, DocumentMediaObject, DocumentMediaTypesEnum, DocumentMessage, EncryptionApi, EncryptionClass, EncryptionPublicKeyResponse, ErrorWebhookValue, ExpressRequest, ExpressResponse, ExpressWebhookConfig, FailedUserInfo, Flow, FlowActionEnum, FlowApi, FlowAsset, FlowAssetsResponse, FlowButton, FlowCategoryEnum, FlowClass, FlowDataExchangeRequest, FlowDataExchangeResponse, FlowDecryptedRequestResponse, FlowEncryptedRequestPayload, FlowEndpointRequest, FlowEndpointResponse, FlowErrorNotificationRequest, FlowErrorNotificationResponse, FlowHandler, FlowHealthCheckRequest, FlowHealthCheckResponse, FlowHttpRequest, FlowMigrationFailure, FlowMigrationResponse, FlowMigrationResult, FlowPreview, FlowPreviewResponse, FlowStatusEnum, FlowSuccessScreenResponse, FlowType, FlowTypeEnum, FlowValidationError, FlowValidationErrorPointer, FlowsListResponse, FooterOptions, GeneralHeaderInterface, GeneralMessageBody, GeneralRequestBody, GetUploadHandleParams, GroupMessage, HeaderOptions, HealthStatus, HealthStatusEntity, HttpMethodsEnum, HttpsClientClass, HttpsClientResponseClass, ImageMediaObject, ImageMediaTypesEnum, ImageMessage, InteractiveButtonReplyMessage, InteractiveListReplyMessage, InteractiveMessage, InteractiveObject, InteractiveTypesEnum, LanguagesEnum, LimitedTimeOfferOptions, LimitedTimeOfferTemplateOptions, ListBlockedUsersParams, ListBlockedUsersResponse, LocationMessage, LocationObject, LocationParameter, LoggerInterface, MPMButton, MPMTemplateOptions, MediaApi, MediaCardCarouselTemplateOptions, MediaCarouselCard, MediaClass, MediaParameter, MediaResponse, MediasResponse, MessagesApi as MessageApi, MessagesApi, MessageHandler, MessageRequestBody, MessageRequestParams, MessageStatus, MessageTemplateObject, MessageTypesEnum, MessageWebhookValue, MessagesClass, MessagesResponse, MessagingLimitTier, MetaError, MetaErrorDetail, NextFunction, NextJsAppWebhookConfig, NextJsWebhookConfig, OTPButton, OTPTemplateOptions, OrderMessage, Pagination, PaginationCursors, Paging, PagingCursors, PagingInfo, ParametersTypesEnum, PhoneNumberApi, PhoneNumberButton, PhoneNumberClass, PhoneNumberResponse, PhoneNumbersResponse, PlatformType, ProductCardCarouselTemplateOptions, ProductCarouselCard, ProductParameter, ProductSection, QrCodeApi, QrCodeClass, QrCodeResponse, QrCodesResponse, QualityRating, QualityScore, QuickReplyButton, ReactionMessage, ReactionParams, ReferralSourceTypesEnum, RegistrationApi, RegistrationClass, RegistrationRequest, RequestCodeMethodsEnum, RequestVerificationCodeRequest, RequesterClass, RequesterResponseInterface, ResponseData, ResponseHeaderValue, ResponseHeaders, ResponseJSONBody, ResponsePagination, ResponseSuccess, SPMButton, SPMTemplateOptions, StatusEnum, StatusParams, StatusWebhook, StatusWebhookValue, StickerMediaObject, StickerMediaTypesEnum, StickerMessage, SubTypeEnum, SystemChangeTypesEnum, SystemMessage, TemplateApi, TemplateBody, TemplateButton, TemplateButtons, TemplateCarousel, TemplateClass, TemplateDeleteParams, TemplateFooter, TemplateFormat, TemplateGetParams, TemplateHeader, TemplateHeaderExample, TemplateLimitedTimeOffer, TemplateOptions, TemplateParameter, TemplateRequestBody, TemplateResponse, TemplateStatusEnum, TextMessage, TextMessageParams, TextObject, TextParameter, Throughput, ThroughputLevel, TwoStepVerificationApi, TwoStepVerificationClass, TwoStepVerificationParams, TwoStepVerificationRequest, URLButton, UnblockUsersRequest, UnsupportedMessage, UpdateBusinessProfileRequest, UpdateFlowResponse, UpdateQrCodeRequest, UpdateWabaSubscription, UploadBusinessProfileResponse, UploadHandle, UploadMediaParams, UploadMediaResponse, UploadSession, UploadSessionResponse, ValidateFlowJsonResponse, VerifyCodeRequest, VideoMediaObject, VideoMediaTypesEnum, VideoMessage, WABAClass, WabaAccount, WabaAccountFields, WabaAccountFieldsParam, WabaAccountReviewStatus, WabaAccountStatus, WabaApi, WabaBusinessVerificationStatus, WabaConfigEnum, WabaConfigType, WabaHealthStatus, WabaHealthStatusCanSendMessage, WabaHealthStatusEntity, WabaHealthStatusError, WabaSubscription, WabaSubscriptions, WebhookContact, WebhookEvent, WebhookMessage, WebhookPayload, WebhookProcessor, WebhookResponse, WebhookTypesEnum, WebhookValue, WhatsApp, WhatsAppConfig, WhatsAppMessage, constructFullUrl, createAuthenticationTemplate, createCatalogTemplate, createCouponTemplate, createFlowErrorResponse, createFlowPingResponse, createLimitedTimeOfferTemplate, createMPMTemplate, createMediaCardCarouselTemplate, createOTPTemplate, createProductCardCarouselTemplate, createSPMTemplate, createTemplate, expressWebhookHandler, generateXHub256Sig, nextjsAppWebhookHandler, nextjsPagesWebhookHandler, processFlowRequest, processWebhookMessages };
+//#region src/utils/buildFieldsQueryString.d.ts
+declare function buildFieldsQueryString(fields?: string[] | string): string;
+//#endregion
+//#region src/utils/configTable.d.ts
+/**
+ * Formats configuration as a terminal table
+ * @param config - The WABA configuration object
+ * @param apiName - The name of the API being initialized
+ * @returns Formatted table string
+ */
+declare function formatConfigTable(config: WabaConfigType): string;
+//#endregion
+//#region src/utils/logger.d.ts
+declare class Logger implements LoggerInterface {
+  private name;
+  private debug;
+  constructor(name: string, debug?: boolean);
+  private formatData;
+  log(...data: any[]): void;
+  error(...data: any[]): void;
+  warn(...data: any[]): void;
+  info(...data: any[]): void;
+}
+//#endregion
+//#region src/utils/objectToQueryString.d.ts
+declare const objectToQueryString: (params: Record<string, any>) => string;
+//#endregion
+//#region src/utils/flowTypeGuards.d.ts
+declare const DATA_EXCHANGE_ACTIONS: readonly [FlowActionEnum.DATA_EXCHANGE, FlowActionEnum.INIT, FlowActionEnum.BACK];
+declare const ERROR_ACTIONS: readonly [FlowActionEnum.DATA_EXCHANGE, FlowActionEnum.INIT];
+/**
+ * Type guard to check if a request is a Data Exchange request
+ * Validates the request structure according to the Flow API specifications
+ *
+ * @param request The Flow endpoint request to check
+ * @returns True if the request is a valid Data Exchange request, false otherwise
+ */
+declare function isFlowDataExchangeRequest(request: FlowEndpointRequest): request is FlowDataExchangeRequest & {
+  action: (typeof DATA_EXCHANGE_ACTIONS)[number];
+  screen?: string;
+  flow_token: string;
+  data?: Record<string, any>;
+};
+/**
+ * Type guard to check if a request is an Error Notification request
+ * Validates the request structure according to the Flow API error specifications
+ *
+ * @param request The Flow endpoint request to check
+ * @returns True if the request is a valid Error Notification request, false otherwise
+ */
+declare function isFlowErrorRequest(request: FlowEndpointRequest): request is FlowErrorNotificationRequest & {
+  action: (typeof ERROR_ACTIONS)[number];
+  screen: string;
+  flow_token: string;
+  data: {
+    error: string;
+    error_message: string;
+  };
+};
+/**
+ * Type guard to check if a request is a Ping (health check) request
+ * Simple validation for health check endpoints in the Flow API
+ *
+ * @param request The Flow endpoint request to check
+ * @returns True if the request is a Ping request, false otherwise
+ */
+declare function isFlowPingRequest(request: FlowEndpointRequest): request is FlowHealthCheckRequest;
+//#endregion
+export { AccountMode, AudioMediaObject, AudioMediaTypesEnum, AudioMessage, AuthenticationTemplateOptions, BaseClass, BlockUserObject, BlockUsersApi, BlockUsersClass, BlockUsersRequest, BlockUsersResponse, BlockedUserInfo, BodyOptions, BusinessProfileApi, BusinessProfileClass, BusinessProfileData, BusinessProfileField, BusinessProfileFieldsParam, BusinessProfileResponse, BusinessVerticalEnum, ButtonMessage, ButtonOptions, ButtonPositionEnum, CarouselCard, CarouselOptions, CatalogButton, CatalogTemplateOptions, CategoryEnum, CodeVerificationStatus, ComponentTypes, ComponentTypesEnum, ContactObject, ContactsMessage, ConversationTypesEnum, CopyCodeButton, CouponTemplateOptions, CreateFlowResponse, CreateQrCodeRequest, CreateUploadSessionParams, CurrencyCodesEnum, CurrencyParameter, Cursors, DataLocalizationRegionEnum, DateTimeParameter, DocumentMediaObject, DocumentMediaTypesEnum, DocumentMessage, EncryptionApi, EncryptionClass, EncryptionKeyPair, EncryptionPublicKeyResponse, ErrorWebhookValue, ExpressRequest, ExpressResponse, ExpressWebhookConfig, FailedUserInfo, Flow, FlowActionEnum, FlowApi, FlowAsset, FlowAssetsResponse, FlowButton, FlowCategoryEnum, FlowClass, FlowDataExchangeRequest, FlowDataExchangeResponse, FlowDecryptedRequestResponse, FlowEncryptedRequestPayload, FlowEndpointRequest, FlowEndpointResponse, FlowErrorNotificationRequest, FlowErrorNotificationResponse, FlowHandler, FlowHealthCheckRequest, FlowHealthCheckResponse, FlowHttpRequest, FlowMigrationFailure, FlowMigrationResponse, FlowMigrationResult, FlowPreview, FlowPreviewResponse, FlowStatusEnum, FlowSuccessScreenResponse, FlowType, FlowTypeEnum, FlowValidationError, FlowValidationErrorPointer, FlowsListResponse, FooterOptions, GeneralHeaderInterface, GeneralMessageBody, GeneralRequestBody, GetUploadHandleParams, GroupMessage, HeaderOptions, HealthStatus, HealthStatusEntity, HttpMethodsEnum, HttpsClientClass, HttpsClientResponseClass, ImageMediaObject, ImageMediaTypesEnum, ImageMessage, InteractiveButtonReplyMessage, InteractiveListReplyMessage, InteractiveMessage, InteractiveObject, InteractiveTypesEnum, LanguagesEnum, LimitedTimeOfferOptions, LimitedTimeOfferTemplateOptions, ListBlockedUsersParams, ListBlockedUsersResponse, LocationMessage, LocationObject, LocationParameter, Logger, LoggerInterface, MPMButton, MPMTemplateOptions, MediaApi, MediaCardCarouselTemplateOptions, MediaCarouselCard, MediaClass, MediaParameter, MediaResponse, MediasResponse, MessagesApi as MessageApi, MessagesApi, MessageHandler, MessageRequestBody, MessageRequestParams, MessageStatus, MessageTemplateObject, MessageTypesEnum, MessageWebhookValue, MessagesClass, MessagesResponse, MessagingLimitTier, MetaError, MetaErrorDetail, NextFunction, NextJsAppWebhookConfig, NextJsWebhookConfig, OTPButton, OTPTemplateOptions, OrderMessage, Pagination, PaginationCursors, Paging, PagingCursors, PagingInfo, ParametersTypesEnum, PhoneNumberApi, PhoneNumberButton, PhoneNumberClass, PhoneNumberResponse, PhoneNumbersResponse, PlatformType, ProcessedMessage, ProcessedStatus, ProductCardCarouselTemplateOptions, ProductCarouselCard, ProductParameter, ProductSection, QrCodeApi, QrCodeClass, QrCodeResponse, QrCodesResponse, QualityRating, QualityScore, QuickReplyButton, ReactionMessage, ReactionParams, ReferralSourceTypesEnum, RegistrationApi, RegistrationClass, RegistrationRequest, RequestCodeMethodsEnum, RequestVerificationCodeRequest, RequesterClass, RequesterResponseInterface, ResponseData, ResponseHeaderValue, ResponseHeaders, ResponseJSONBody, ResponsePagination, ResponseSuccess, SPMButton, SPMTemplateOptions, StatusEnum, StatusHandler, StatusParams, StatusWebhook, StatusWebhookValue, StickerMediaObject, StickerMediaTypesEnum, StickerMessage, SubTypeEnum, SystemChangeTypesEnum, SystemMessage, TemplateApi, TemplateBody, TemplateButton, TemplateButtons, TemplateCarousel, TemplateClass, TemplateDeleteParams, TemplateFooter, TemplateFormat, TemplateGetParams, TemplateHeader, TemplateHeaderExample, TemplateLimitedTimeOffer, TemplateOptions, TemplateParameter, TemplateRequestBody, TemplateResponse, TemplateStatusEnum, TextMessage, TextMessageParams, TextObject, TextParameter, Throughput, ThroughputLevel, TwoStepVerificationApi, TwoStepVerificationClass, TwoStepVerificationParams, TwoStepVerificationRequest, URLButton, UnblockUsersRequest, UnsupportedMessage, UpdateBusinessProfileRequest, UpdateFlowResponse, UpdateQrCodeRequest, UpdateWabaSubscription, UploadBusinessProfileResponse, UploadHandle, UploadMediaParams, UploadMediaResponse, UploadSession, UploadSessionResponse, ValidateFlowJsonResponse, VerifyCodeRequest, VideoMediaObject, VideoMediaTypesEnum, VideoMessage, WABAClass, WabaAccount, WabaAccountFields, WabaAccountFieldsParam, WabaAccountReviewStatus, WabaAccountStatus, WabaApi, WabaBusinessVerificationStatus, WabaConfigEnum, WabaConfigType, WabaHealthStatus, WabaHealthStatusCanSendMessage, WabaHealthStatusEntity, WabaHealthStatusError, WabaSubscription, WabaSubscriptions, WebhookContact, WebhookEvent, WebhookMessage, WebhookPayload, WebhookProcessor, WebhookResponse, WebhookTypesEnum, WebhookValue, WhatsApp, WhatsAppConfig, WhatsAppMessage, buildFieldsQueryString, constructFullUrl, createAuthenticationTemplate, createCatalogTemplate, createCouponTemplate, createLimitedTimeOfferTemplate, createMPMTemplate, createMediaCardCarouselTemplate, createOTPTemplate, createProductCardCarouselTemplate, createSPMTemplate, createTemplate, expressWebhookHandler, formatConfigTable, generateEncryption, generateXHub256Sig, isFlowDataExchangeRequest, isFlowErrorRequest, isFlowPingRequest, isMetaError, nextjsAppWebhookHandler, nextjsPagesWebhookHandler, objectToQueryString, processFlowRequest, processWebhookMessages };
 //# sourceMappingURL=index.d.ts.map