meta-cloud-api 3.8.0 → 3.9.1

package/dist/index.d.mts

@@ -1,7 +1,81 @@
-import { Agent } from "node:https";
 import { IncomingHttpHeaders, IncomingMessage } from "node:http";
 
-//#region src/types/enums.d.ts
+//#region src/utils/rateLimit.d.ts
+/**
+ * Usage percentages reported by Meta. Each value is the share (0-100+) of the allowance used in the
+ * current rolling window.
+ */
+interface RateLimitUsage {
+  /** Percentage of calls made (`call_count`). */
+  callCount?: number;
+  /** Percentage of total CPU time used (`total_cputime`). */
+  totalCputime?: number;
+  /** Percentage of total time used (`total_time`). */
+  totalTime?: number;
+}
+/** One entry of the `X-Business-Use-Case-Usage` header. */
+interface BusinessUseCaseUsage extends RateLimitUsage {
+  /** The business object the entry belongs to (for WhatsApp, usually the WABA or phone number ID). */
+  businessId: string;
+  /** Rate limit type, e.g. `whatsapp_business_management` or `whatsapp`. */
+  type?: string;
+  /**
+   * `estimated_time_to_regain_access`: "Time, in minutes, until calls will no longer be throttled."
+   * `0` when not throttled.
+   */
+  estimatedTimeToRegainAccessMinutes?: number;
+  /** `ads_api_access_tier`, only sent for Marketing API use cases. */
+  adsApiAccessTier?: string;
+}
+/**
+ * Rate limit information parsed from a Graph API response.
+ *
+ * WhatsApp Cloud API responses carry `x-business-use-case-usage` (types
+ * `whatsapp_business_management` and `whatsapp`) and `x-app-usage`; throttled responses may add
+ * `Retry-After` (seconds).
+ */
+interface RateLimitInfo {
+  /** Parsed `X-App-Usage` header (platform rate limits). */
+  appUsage?: RateLimitUsage;
+  /** Parsed `X-Business-Use-Case-Usage` header, flattened across business IDs. Empty when absent. */
+  businessUseCaseUsage: BusinessUseCaseUsage[];
+  /** Parsed `Retry-After` header in milliseconds (seconds or HTTP-date form). */
+  retryAfterMs?: number;
+  /**
+   * Highest usage percentage across every parsed metric, handy for alerting before Meta starts
+   * throttling (it throttles at 100).
+   */
+  maxUsagePercent?: number;
+  /**
+   * How long Meta asks you to wait, in milliseconds: the larger of `retryAfterMs` and the largest
+   * `estimatedTimeToRegainAccessMinutes`. Undefined when Meta gave no wait time.
+   */
+  retryDelayMs?: number;
+}
+/** Headers accepted by {@link parseRateLimitHeaders}. */
+type RateLimitHeadersInput = Headers | Record<string, string | string[] | undefined> | {
+  get(name: string): string | null;
+};
+/**
+ * Parses a `Retry-After` value (delta-seconds or HTTP-date) into milliseconds.
+ * Returns undefined for missing or malformed values.
+ */
+declare function parseRetryAfter(value: string | null | undefined, now?: number): number | undefined;
+/**
+ * Parses Meta's rate limit headers (`X-App-Usage`, `X-Business-Use-Case-Usage`, `Retry-After`).
+ * Header names are matched case-insensitively. Malformed JSON or values are ignored, never thrown.
+ *
+ * Returns undefined when none of the headers are present.
+ *
+ * @see {@link https://developers.facebook.com/docs/graph-api/overview/rate-limiting/ | Graph API rate limiting}
+ *
+ * @example
+ * ```ts
+ * const info = parseRateLimitHeaders(response.headers);
+ * if ((info?.maxUsagePercent ?? 0) > 80) slowDown();
+ * ```
+ */
+declare function parseRateLimitHeaders(headers: RateLimitHeadersInput | null | undefined): RateLimitInfo | undefined;
 declare namespace enums_d_exports {
   export { AudioMediaTypesEnum, BusinessVerticalEnum, ButtonPositionEnum, CategoryEnum, ComponentTypesEnum, ConversationTypesEnum, CurrencyCodesEnum, DataLocalizationRegionEnum, DocumentMediaTypesEnum, HttpMethodsEnum, ImageMediaTypesEnum, InteractiveTypesEnum, LanguagesEnum, MessageCategoryEnum, MessageTypesEnum, ParametersTypesEnum, ReferralSourceTypesEnum, RequestCodeMethodsEnum, StatusEnum, StickerMediaTypesEnum, SubTypeEnum, SystemChangeTypesEnum, TemplateStatusEnum, VideoMediaTypesEnum, WabaConfigEnum, WebhookTypesEnum };
 }
@@ -735,6 +809,68 @@ interface RetryConfig {
    * Defaults to 1000 (1 second).
    */
   initialDelayMs?: number;
+  /**
+   * Wait as long as Meta asks before retrying a throttled request. When a throttling response
+   * carries `Retry-After` (seconds) or `X-Business-Use-Case-Usage` with
+   * `estimated_time_to_regain_access` (minutes), the retry waits the larger of the backoff delay and
+   * that server delay, capped at {@link RetryConfig.maxServerDelayMs}. It never adds attempts.
+   * Defaults to `true`; set `false` to use the backoff delay only.
+   */
+  respectServerDelay?: boolean;
+  /**
+   * Upper bound in milliseconds for a server-provided wait. A longer wait is shortened to this
+   * value, so the retry may still be throttled; inspect `error.rateLimit` to reschedule instead.
+   * Defaults to 30000 (30 seconds).
+   */
+  maxServerDelayMs?: number;
+}
+/** Request details passed to {@link WhatsAppConfig.onRateLimitInfo}. */
+interface RateLimitInfoContext {
+  /** HTTP method of the request. */
+  method: string;
+  /** Endpoint path or absolute URL as passed to the requester. */
+  endpoint: string;
+  /** HTTP status code of the response. */
+  statusCode: number;
+}
+/** Callback receiving rate limit information parsed from every response that carries it. */
+type RateLimitInfoListener = (info: RateLimitInfo, context: RateLimitInfoContext) => void | Promise<void>;
+/**
+ * Storage used to drop duplicate webhook deliveries. Meta retries deliveries,
+ * so the same message or status can arrive more than once.
+ *
+ * `setIfAbsent` must be atomic: store `key` for `ttlSeconds` only if it is not
+ * already there, and resolve `true` when it stored the key (first delivery) or
+ * `false` when the key already existed (duplicate). It maps 1:1 to Redis
+ * `SET key 1 NX EX ttlSeconds`, which replies `OK` only when the key was set.
+ *
+ * @example
+ * ```typescript
+ * const store: DedupeStore = {
+ *     async setIfAbsent(key, ttlSeconds) {
+ *         return (await redis.set(`wa:${key}`, '1', { NX: true, EX: ttlSeconds })) === 'OK';
+ *     },
+ * };
+ * ```
+ */
+interface DedupeStore {
+  /** Atomically store `key` for `ttlSeconds` if absent. Resolves `true` if stored, `false` if it existed. */
+  setIfAbsent(key: string, ttlSeconds: number): Promise<boolean>;
+  /** Optional read-only check. The webhook processor never calls it; it is there for inspection and tests. */
+  has?(key: string): Promise<boolean>;
+}
+/**
+ * Opt-in deduplication of webhook deliveries. See {@link DedupeStore}.
+ */
+interface WebhookDedupeConfig {
+  /**
+   * Where seen keys are kept. Defaults to an in-memory store that is bounded
+   * and only sees deliveries made to this process: with several instances
+   * behind a load balancer, pass a shared store such as Redis.
+   */
+  store?: DedupeStore;
+  /** How long a key is remembered, in seconds. Defaults to 86400 (24 hours). */
+  ttlSeconds?: number;
 }
 type WhatsAppConfig = {
   accessToken: string;
@@ -752,6 +888,12 @@ type WhatsAppConfig = {
   privatePem?: string;
   passphrase?: string; /** Automatic retry configuration for throttling errors. */
   retry?: RetryConfig;
+  /**
+   * Called with the parsed `X-App-Usage` / `X-Business-Use-Case-Usage` / `Retry-After` headers of
+   * every response (successful or not) that carries at least one of them. Errors thrown by the
+   * callback are ignored. See also `whatsapp.getLastRateLimitInfo()`.
+   */
+  onRateLimitInfo?: RateLimitInfoListener;
   /**
    * Reject webhook POSTs whose `X-Hub-Signature-256` header is not a valid
    * HMAC-SHA256 of the raw body keyed with `appSecret`. Requires `appSecret`.
@@ -763,6 +905,19 @@ type WhatsAppConfig = {
    * `app.use(express.json({ verify: (req, _res, buf) => { req.rawBody = buf.toString(); } }))`.
    */
   verifyWebhookSignature?: boolean;
+  /**
+   * Skip handlers for webhook deliveries that were already seen (Meta retries
+   * deliveries). Duplicates still get a 200 response. Used by
+   * `WebhookProcessor` and the framework adapters only.
+   *
+   * Keys: `message:<id>` for messages, `status:<id>:<status>` for statuses,
+   * and the call or echo ids for `calls`, `smb_message_echoes` and
+   * `message_echoes`. Other fields have no natural id and are never deduped.
+   *
+   * `true` uses the defaults (in-memory store, single instance only, 24 hour TTL).
+   * Off by default.
+   */
+  dedupe?: boolean | WebhookDedupeConfig;
 };
 type WabaConfigType = {
   /**
@@ -826,6 +981,10 @@ type WabaConfigType = {
    * Passed through from WhatsAppConfig.
    */
   retry?: RetryConfig;
+  /**
+   * Rate limit header listener. Passed through from WhatsAppConfig.
+   */
+  onRateLimitInfo?: RateLimitInfoListener;
 };
 //#endregion
 //#region src/types/request.d.ts
@@ -851,6 +1010,8 @@ interface GeneralHeaderInterface {
 }
 interface RequesterResponseInterface<T> {
   json: () => Promise<T>;
+  /** The underlying fetch `Response`, for non-JSON bodies such as media downloads. */
+  rawResponse: () => Response;
 }
 interface ResponseSuccess {
   success: boolean;
@@ -899,6 +1060,8 @@ declare class BaseAPI implements BaseClass {
   protected client: RequesterClass;
   constructor(config: WabaConfigType, client: RequesterClass);
   protected sendJson<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
+  /** Send a request and return the raw `Response` (for binary bodies). Errors still throw `WhatsAppError`s. */
+  protected sendRaw(method: HttpMethodsEnum, endpoint: string, timeout: number): Promise<Response>;
   protected sendFormData<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body?: any): Promise<T>;
   protected sendUrlEncodedForm<T>(method: HttpMethodsEnum, endpoint: string, timeout: number, body: UrlEncodedFormBody): Promise<T>;
 }
@@ -1712,7 +1875,7 @@ type GroupParticipantsRequest = {
 type UpdateGroupSettingsRequest = {
   subject?: string;
   description?: string;
-  profilePictureFile?: Blob | Buffer;
+  profilePictureFile?: Blob | Uint8Array;
 };
 type GroupSettingsResponse = ResponseSuccess;
 interface GroupsClass {
@@ -2398,9 +2561,29 @@ type MediasResponse = {
 type UploadMediaResponse = {
   id: string;
 };
+/**
+ * Media content accepted by `uploadMedia`.
+ *
+ * A `ReadableStream` is read fully into memory before the upload starts: Meta's endpoint takes
+ * `multipart/form-data`, and `fetch` can only send a `FormData` part from a `Blob`.
+ */
+type UploadMediaInput = Blob | File | Uint8Array | ArrayBuffer | ReadableStream<Uint8Array>;
+interface UploadMediaOptions {
+  /**
+   * MIME type sent as the `type` field and as the file part's content type, e.g. `image/jpeg`.
+   * Required for `Uint8Array`, `ArrayBuffer` and `ReadableStream` input, and for a `Blob` without a
+   * `type`. Overrides the `type` of a `Blob`/`File`.
+   */
+  type?: string;
+  /** File name of the multipart part. Defaults to the `File` name, otherwise `file`. */
+  filename?: string;
+  /** Messaging product. Defaults to `'whatsapp'`. */
+  messagingProduct?: string;
+}
 interface MediaClass {
   getMediaById(mediaId: string): Promise<MediaResponse>;
   uploadMedia(file: File, messagingProduct?: string): Promise<UploadMediaResponse>;
+  uploadMedia(file: UploadMediaInput, options?: UploadMediaOptions): Promise<UploadMediaResponse>;
   deleteMedia(mediaId: string): Promise<ResponseSuccess>;
   downloadMedia(mediaUrl: string): Promise<Blob>;
 }
@@ -2762,9 +2945,9 @@ interface UploadMediaParams {
    */
   uploadId: string;
   /**
-   * The binary data of the file (Buffer).
+   * The binary data of the file (`Uint8Array`; a Node.js `Buffer` works).
    */
-  file: Buffer;
+  file: Uint8Array;
 }
 /**
  * Request parameters for getting upload handle.
@@ -2909,7 +3092,7 @@ declare class BusinessProfileClass extends BaseClass {
    * @param uploadId The ID of the upload session.
    * @param file The binary data of the file.
    */
-  uploadMedia(uploadId: string, file: Buffer): Promise<UploadBusinessProfileResponse>;
+  uploadMedia(uploadId: string, file: Uint8Array): Promise<UploadBusinessProfileResponse>;
   /**
    * Get the upload handle information.
    * @param uploadId The ID of the upload session.
@@ -3542,7 +3725,7 @@ type WabaBanState = 'SCHEDULE_FOR_DISABLE' | 'DISABLE' | 'REINSTATE';
 /**
  * Restriction types imposed on WABA — present on ACCOUNT_RESTRICTION events.
  */
-type RestrictionType = 'RESTRICTION_ADD_PHONE_NUMBER_ACTION' | 'RESTRICTED_BIZ_INITIATED_MESSAGING' | 'RESTRICTED_CUSTOMER_INITIATED_MESSAGING';
+type RestrictionType = 'RESTRICTED_ADD_PHONE_NUMBER_ACTION' /** @deprecated Misspelled legacy value; Meta sends `RESTRICTED_ADD_PHONE_NUMBER_ACTION`. */ | 'RESTRICTION_ADD_PHONE_NUMBER_ACTION' | 'RESTRICTED_BIZ_INITIATED_MESSAGING' | 'RESTRICTED_CUSTOMER_INITIATED_MESSAGING' | 'RESTRICTED_BIZ_INITIATED_AND_USER_INITIATED_CALLING' | 'RESTRICTED_BUSINESS_INITIATED_CALLING' | 'RESTRICTED_USER_INITIATED_CALLING' | 'RESTRICTED_USER_INITIATED_CALLING_CALL_BUTTON_HIDDEN' | 'RESTRICTED_DIRECT_SEND_UTILITY_TEMPLATES' | 'RESTRICTED_UTILITY_TEMPLATES';
 /**
  * Reason for the disconnection — present on PARTNER_REMOVED events where
  * the business used both WhatsApp Business app and Cloud API.
@@ -3630,7 +3813,12 @@ interface PartnerClientCertificationInfo {
   rejection_reasons?: string[];
 }
 interface AccountUpdateValue {
-  /** Phone number associated with the WABA, if applicable */
+  /**
+   * Business display phone number the event applies to (e.g. "15550783881").
+   * Only included for events about a single business phone number, such as
+   * ACCOUNT_VIOLATION and calling-related ACCOUNT_RESTRICTION events.
+   * Absent on WABA-wide events.
+   */
   phone_number?: string;
   /**
    * Event type describing what changed.
@@ -5372,6 +5560,21 @@ type WebhookValue = MessageWebhookValue | StatusWebhookValue | ErrorWebhookValue
  * Union type for all webhook field values
  */
 type WebhookFieldValue = AccountUpdateWebhookValue | AccountReviewUpdateWebhookValue | AccountAlertsWebhookValue | AccountSettingsUpdateWebhookValue | AutomaticEventsWebhookValue | BusinessCapabilityUpdateWebhookValue | BusinessStatusUpdateWebhookValue | BusinessUsernameUpdatesWebhookValue | CallsWebhookValue | FlowsWebhookValue | GroupLifecycleUpdateWebhookValue | GroupParticipantsUpdateWebhookValue | GroupSettingsUpdateWebhookValue | GroupStatusUpdateWebhookValue | HistoryWebhookValue | MessageEchoesWebhookValue | MessageTemplateComponentsUpdateWebhookValue | MessageTemplateQualityUpdateWebhookValue | MessageTemplateStatusUpdateWebhookValue | MessagingHandoversWebhookValue | PartnerSolutionsWebhookValue | PaymentConfigurationUpdateWebhookValue | PhoneNumberNameUpdateWebhookValue | PhoneNumberQualityUpdateWebhookValue | SecurityWebhookValue | SmbAppStateSyncWebhookValue | SmbMessageEchoesWebhookValue | StandbyWebhookValue | TemplateCategoryUpdateWebhookValue | TemplateCorrectCategoryDetectionWebhookValue | TrackingEventsWebhookValue | UserPreferencesWebhookValue;
+/**
+ * Maps every webhook field except `messages` to the type of its `value`.
+ * `messages` is left out because the SDK splits it into messages, statuses and
+ * user actions (see `onMessage`, `onStatus` and `onUserAction`).
+ *
+ * @example
+ * ```typescript
+ * type Calls = WebhookFieldValueMap['calls']; // CallsWebhookValue['value']
+ * ```
+ */
+type WebhookFieldValueMap = { [F in WebhookFieldValue['field']]: Extract<WebhookFieldValue, {
+  field: F;
+}>['value'] };
+/** Webhook field names accepted by `WebhookProcessor.on()`: every field except `messages`. */
+type NonMessageWebhookField = keyof WebhookFieldValueMap;
 interface WebhookPayload {
   object: 'whatsapp_business_account';
   entry: Array<{
@@ -5462,6 +5665,11 @@ declare class WhatsAppError extends Error {
 declare class WhatsAppApiError extends WhatsAppError {
   readonly error: MetaErrorData;
   readonly statusCode?: number;
+  /**
+   * Rate limit headers of the failed response, when it carried any. Set by the SDK's requester;
+   * use `rateLimit.retryDelayMs` to reschedule a throttled call.
+   */
+  rateLimit?: RateLimitInfo;
   constructor(message: string, error: MetaErrorData, statusCode?: number);
 }
 declare class WhatsAppAuthorizationError extends WhatsAppApiError {
@@ -6197,7 +6405,7 @@ interface FlowClass {
    * @returns Promise with the success status and validation errors
    */
   updateFlowJson(flowId: string, data: {
-    file: Blob | Buffer | object;
+    file: Blob | Uint8Array | object;
     name?: string;
   }): Promise<UpdateFlowResponse>;
   /**
@@ -6208,7 +6416,7 @@ interface FlowClass {
    * @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>;
+  validateFlowJson(flowId: string, flowJsonData: Blob | Uint8Array | object): Promise<ValidateFlowJsonResponse>;
   /**
    * Publish Flow
    *
@@ -6462,7 +6670,7 @@ declare class FlowApi extends BaseAPI implements FlowClass {
    * ```
    */
   updateFlowJson(flowId: string, data: {
-    file: Blob | Buffer | object;
+    file: Blob | Uint8Array | object;
     name?: string;
   }): Promise<UpdateFlowResponse>;
   /**
@@ -6492,7 +6700,7 @@ declare class FlowApi extends BaseAPI implements FlowClass {
    * }
    * ```
    */
-  validateFlowJson(flowId: string, flowJsonData: Blob | Buffer | object): Promise<ValidateFlowJsonResponse>;
+  validateFlowJson(flowId: string, flowJsonData: Blob | Uint8Array | object): Promise<ValidateFlowJsonResponse>;
   /**
    * Publish a flow.
    *
@@ -6822,11 +7030,24 @@ declare class MediaApi extends BaseAPI implements MediaClass {
    * messages containing that media. Media is automatically encrypted and stored
    * on Meta's servers.
    *
-   * **Endpoint:** `POST /{PHONE_NUMBER_ID}/media`
+   * **Endpoint:** `POST /{PHONE_NUMBER_ID}/media` (`multipart/form-data` with `file`, `type` and
+   * `messaging_product`)
+   *
+   * Accepts a `File`, `Blob`, `Uint8Array` (including a Node.js `Buffer`), `ArrayBuffer` or web
+   * `ReadableStream<Uint8Array>` on every runtime. Pass the MIME type in `options.type` unless the
+   * input is a `Blob`/`File` that already has one.
    *
-   * @param file - The `File` object to upload. The `type` property must match a supported MIME type.
-   * @param messagingProduct - The messaging product identifier (defaults to `'whatsapp'`)
+   * **Memory:** a `ReadableStream` is read fully into a `Blob` before the request is sent. Meta
+   * requires a multipart body and `fetch` only accepts `Blob` parts in `FormData`, so the upload is
+   * not streamed end to end. Peak memory can exceed the file size (Meta caps media at 100 MB for
+   * documents, 16 MB for audio/video, 5 MB for images). Buffering once also lets a throttled upload
+   * be retried. Blob construction snapshots byte inputs; allow room for these copies.
+   *
+   * @param file - The content to upload
+   * @param optionsOrMessagingProduct - Upload options, or the messaging product string (legacy form,
+   * defaults to `'whatsapp'`)
    * @returns A promise resolving to the upload response containing the assigned `id` (media ID)
+   * @throws WhatsAppValidationError when no MIME type is available or the input type is unsupported
    *
    * @see {@link https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#upload-media | Upload Media Reference}
    *
@@ -6834,11 +7055,14 @@ declare class MediaApi extends BaseAPI implements MediaClass {
    * ```ts
    * const file = new File([buffer], 'image.jpg', { type: 'image/jpeg' });
    * const { id } = await client.media.uploadMedia(file);
-   * // Use the media ID to send an image message
-   * await client.messages.image({ body: { id }, to: '1234567890' });
+   *
+   * // Bytes or a web stream (e.g. a fetch() body) need a MIME type
+   * const res = await fetch('https://example.com/report.pdf');
+   * await client.media.uploadMedia(res.body!, { type: 'application/pdf', filename: 'report.pdf' });
    * ```
    */
   uploadMedia(file: File, messagingProduct?: string): Promise<UploadMediaResponse>;
+  uploadMedia(file: UploadMediaInput, options?: UploadMediaOptions): Promise<UploadMediaResponse>;
   /**
    * Deletes a media file from WhatsApp servers.
    *
@@ -8119,7 +8343,7 @@ declare class BusinessProfileApi extends BaseAPI implements BusinessProfileClass
    * );
    * ```
    */
-  uploadMedia(uploadId: string, file: Buffer): Promise<UploadBusinessProfileResponse>;
+  uploadMedia(uploadId: string, file: Uint8Array): Promise<UploadBusinessProfileResponse>;
   /**
    * Get the upload handle for a completed upload.
    *
@@ -8853,7 +9077,7 @@ type EncryptionKeyPair = {
  */
 declare function generateEncryption(passphrase?: string): EncryptionKeyPair;
 /**
- * Decrypt a WhatsApp Flow request
+ * Decrypt a WhatsApp Flow request (Node.js only; see {@link decryptFlowRequestAsync} for every runtime)
  * @param body - Encrypted request body containing encrypted_aes_key, encrypted_flow_data, and initial_vector
  * @param config - WABA configuration containing FLOW_API_PRIVATE_PEM and FLOW_API_PASSPHRASE
  * @returns Decrypted flow request body, AES key buffer, and initial vector buffer
@@ -8865,7 +9089,7 @@ declare function decryptFlowRequest(body: any, config: WabaConfigType): {
   initialVectorBuffer: Buffer;
 };
 /**
- * Encrypt a WhatsApp Flow response
+ * Encrypt a WhatsApp Flow response (Node.js only; see {@link encryptFlowResponseAsync} for every runtime)
  * @param response - Response object to encrypt
  * @param aesKeyBuffer - AES key buffer from the decrypted request
  * @param initialVectorBuffer - Initial vector buffer from the decrypted request
@@ -8873,11 +9097,42 @@ declare function decryptFlowRequest(body: any, config: WabaConfigType): {
  * @throws {Error} If encryption fails
  */
 declare function encryptFlowResponse(response: any, aesKeyBuffer: Buffer, initialVectorBuffer: Buffer): string;
+/**
+ * Result of {@link decryptFlowRequestAsync}. Pass `aesKeyBuffer` and
+ * `initialVectorBuffer` to {@link encryptFlowResponseAsync}.
+ */
+type DecryptedFlowRequest = {
+  decryptedBody: FlowEndpointRequest;
+  aesKeyBuffer: Uint8Array<ArrayBuffer>;
+  initialVectorBuffer: Uint8Array<ArrayBuffer>;
+};
+/**
+ * Decrypt a WhatsApp Flow request with Web Crypto. Works on Node.js, Bun, Deno,
+ * Cloudflare Workers and Vercel Edge.
+ *
+ * On runtimes without `node:crypto` the private key must be an unencrypted
+ * PKCS#8 PEM (`-----BEGIN PRIVATE KEY-----`); the passphrase is then ignored.
+ *
+ * @param body - Encrypted request body containing encrypted_aes_key, encrypted_flow_data, and initial_vector
+ * @param config - WABA configuration containing FLOW_API_PRIVATE_PEM and (for encrypted keys) FLOW_API_PASSPHRASE
+ * @throws {Error} If required encryption properties are missing or decryption fails
+ */
+declare function decryptFlowRequestAsync(body: any, config: WabaConfigType): Promise<DecryptedFlowRequest>;
+/**
+ * Encrypt a WhatsApp Flow response with Web Crypto. Works on every runtime.
+ * @param response - Response object to encrypt
+ * @param aesKeyBuffer - AES key from {@link decryptFlowRequestAsync} (a Node.js Buffer also works)
+ * @param initialVectorBuffer - Initial vector from {@link decryptFlowRequestAsync} (a Node.js Buffer also works)
+ * @returns Base64-encoded encrypted response
+ */
+declare function encryptFlowResponseAsync(response: any, aesKeyBuffer: Uint8Array, initialVectorBuffer: Uint8Array): Promise<string>;
 //#endregion
 //#region src/utils/http/httpsClient.d.ts
 declare class HttpsClient implements HttpsClientClass {
-  agent: Agent;
-  constructor();
+  /**
+   * Kept for backwards compatibility. Requests go through the global `fetch`,
+   * which manages its own connection pool, so there is nothing to clear.
+   */
   clearSockets(): boolean;
   sendRequest(hostname: string, path: string, method: HttpMethodsEnum, headers: HeadersInit, timeout: number, body?: BodyInit | null): Promise<HttpsClientResponseClass>;
 }
@@ -8893,7 +9148,16 @@ declare class Requester implements RequesterClass {
   host: Readonly<string>;
   protocol: Readonly<string>;
   private retryConfig;
-  constructor(apiVersion: string, phoneNumberId: number, accessToken: string, businessAcctId: string, userAgent: string, retryConfig?: RetryConfig);
+  private onRateLimitInfo;
+  private lastRateLimitInfo;
+  constructor(apiVersion: string, phoneNumberId: number, accessToken: string, businessAcctId: string, userAgent: string, retryConfig?: RetryConfig, onRateLimitInfo?: RateLimitInfoListener);
+  /**
+   * Rate limit headers of the most recent response that carried any, or undefined.
+   * With concurrent requests this is whichever response finished last; use the
+   * `onRateLimitInfo` config callback to see every response.
+   */
+  getLastRateLimitInfo(): RateLimitInfo | undefined;
+  private captureRateLimitInfo;
   buildHeader(contentType: string, additionalHeaders?: Record<string, string>): HeadersInit;
   buildCAPIPath(endpoint: string): string;
   private normalizeApiVersion;
@@ -8943,6 +9207,13 @@ declare class WhatsApp {
   updateTimeout(timeout: number): void;
   updateSenderNumberId(phoneNumberId: number): void;
   updateAccessToken(accessToken: string): void;
+  /**
+   * Rate limit headers (`X-App-Usage`, `X-Business-Use-Case-Usage`, `Retry-After`) of the most
+   * recent response that carried any, or undefined before the first such response. With
+   * concurrent requests this reflects whichever finished last; pass `onRateLimitInfo` in the
+   * config to observe every response.
+   */
+  getLastRateLimitInfo(): RateLimitInfo | undefined;
   /**
    * Get SDK version
    */
@@ -8986,6 +9257,35 @@ declare class WhatsApp {
   generateEncryption(passphrase?: string): EncryptionKeyPair;
 }
 //#endregion
+//#region src/core/webhook/dedupe.d.ts
+interface MemoryDedupeStoreOptions {
+  /** Most keys kept at once; the least recently seen key is dropped first. Defaults to 10,000. */
+  maxEntries?: number;
+}
+/**
+ * Bounded in-memory {@link DedupeStore} with per-key TTL and least recently
+ * seen eviction. This is the default store for `dedupe`.
+ *
+ * Single instance only: it lives in this process's memory, so it does not see
+ * deliveries handled by other instances and forgets everything on restart (and
+ * on each cold start of a serverless function). Use a shared store such as
+ * Redis when you run more than one instance.
+ */
+declare class MemoryDedupeStore implements DedupeStore {
+  private readonly maxEntries;
+  /** key -> expiry time in ms. Map order doubles as recency order (oldest first). */
+  private readonly entries;
+  constructor(options?: MemoryDedupeStoreOptions);
+  has(key: string): Promise<boolean>;
+  setIfAbsent(key: string, ttlSeconds: number): Promise<boolean>;
+  /** Number of keys currently held (expired keys may still be counted until evicted). */
+  get size(): number;
+  /** Forget every key. */
+  clear(): void;
+  private lookup;
+  private evict;
+}
+//#endregion
 //#region src/core/webhook/utils/webhookUtils.d.ts
 /**
  * Processed message with metadata for handlers
@@ -9030,135 +9330,12 @@ type ProcessedUserAction = {
   action: UserAction;
 };
 /**
- * Processed webhook field types for specialized handlers
+ * What a handler for a non-`messages` webhook field receives: the WhatsApp
+ * Business Account id and the change's `value`, typed by field name.
  */
-type ProcessedAccountUpdate = {
-  wabaId: string;
-  value: AccountUpdateWebhookValue['value'];
-};
-type ProcessedAccountReviewUpdate = {
-  wabaId: string;
-  value: AccountReviewUpdateWebhookValue['value'];
-};
-type ProcessedAccountAlerts = {
-  wabaId: string;
-  value: AccountAlertsWebhookValue['value'];
-};
-type ProcessedBusinessCapabilityUpdate = {
-  wabaId: string;
-  value: BusinessCapabilityUpdateWebhookValue['value'];
-};
-type ProcessedPhoneNumberNameUpdate = {
-  wabaId: string;
-  value: PhoneNumberNameUpdateWebhookValue['value'];
-};
-type ProcessedPhoneNumberQualityUpdate = {
-  wabaId: string;
-  value: PhoneNumberQualityUpdateWebhookValue['value'];
-};
-type ProcessedMessageTemplateStatusUpdate = {
-  wabaId: string;
-  value: MessageTemplateStatusUpdateWebhookValue['value'];
-};
-type ProcessedTemplateCategoryUpdate = {
-  wabaId: string;
-  value: TemplateCategoryUpdateWebhookValue['value'];
-};
-type ProcessedMessageTemplateQualityUpdate = {
-  wabaId: string;
-  value: MessageTemplateQualityUpdateWebhookValue['value'];
-};
-type ProcessedFlows = {
-  wabaId: string;
-  value: FlowsWebhookValue['value'];
-};
-type ProcessedSecurity = {
-  wabaId: string;
-  value: SecurityWebhookValue['value'];
-};
-type ProcessedHistory = {
-  wabaId: string;
-  value: HistoryWebhookValue['value'];
-};
-type ProcessedSmbMessageEchoes = {
-  wabaId: string;
-  value: SmbMessageEchoesWebhookValue['value'];
-};
-type ProcessedSmbAppStateSync = {
-  wabaId: string;
-  value: SmbAppStateSyncWebhookValue['value'];
-};
-type ProcessedAccountSettingsUpdate = {
-  wabaId: string;
-  value: AccountSettingsUpdateWebhookValue['value'];
-};
-type ProcessedAutomaticEvents = {
-  wabaId: string;
-  value: AutomaticEventsWebhookValue['value'];
-};
-type ProcessedBusinessStatusUpdate = {
-  wabaId: string;
-  value: BusinessStatusUpdateWebhookValue['value'];
-};
-type ProcessedBusinessUsernameUpdates = {
-  wabaId: string;
-  value: BusinessUsernameUpdatesWebhookValue['value'];
-};
-type ProcessedCalls = {
-  wabaId: string;
-  value: CallsWebhookValue['value'];
-};
-type ProcessedGroupLifecycleUpdate = {
-  wabaId: string;
-  value: GroupLifecycleUpdateWebhookValue['value'];
-};
-type ProcessedGroupParticipantsUpdate = {
-  wabaId: string;
-  value: GroupParticipantsUpdateWebhookValue['value'];
-};
-type ProcessedGroupSettingsUpdate = {
+type ProcessedWebhookField<F extends NonMessageWebhookField> = {
   wabaId: string;
-  value: GroupSettingsUpdateWebhookValue['value'];
-};
-type ProcessedGroupStatusUpdate = {
-  wabaId: string;
-  value: GroupStatusUpdateWebhookValue['value'];
-};
-type ProcessedMessageEchoes = {
-  wabaId: string;
-  value: MessageEchoesWebhookValue['value'];
-};
-type ProcessedMessageTemplateComponentsUpdate = {
-  wabaId: string;
-  value: MessageTemplateComponentsUpdateWebhookValue['value'];
-};
-type ProcessedMessagingHandovers = {
-  wabaId: string;
-  value: MessagingHandoversWebhookValue['value'];
-};
-type ProcessedPartnerSolutions = {
-  wabaId: string;
-  value: PartnerSolutionsWebhookValue['value'];
-};
-type ProcessedPaymentConfigurationUpdate = {
-  wabaId: string;
-  value: PaymentConfigurationUpdateWebhookValue['value'];
-};
-type ProcessedStandby = {
-  wabaId: string;
-  value: StandbyWebhookValue['value'];
-};
-type ProcessedTemplateCorrectCategoryDetection = {
-  wabaId: string;
-  value: TemplateCorrectCategoryDetectionWebhookValue['value'];
-};
-type ProcessedTrackingEvents = {
-  wabaId: string;
-  value: TrackingEventsWebhookValue['value'];
-};
-type ProcessedUserPreferences = {
-  wabaId: string;
-  value: UserPreferencesWebhookValue['value'];
+  value: WebhookFieldValueMap[F];
 };
 type TextProcessedMessage = ProcessedMessage & {
   message: Extract<WhatsAppMessage, {
@@ -9245,38 +9422,50 @@ type StatusHandler = WebhookHandler<ProcessedStatus>;
 type UserActionHandler = WebhookHandler<ProcessedUserAction>;
 type FlowHandler = WebhookHandler<FlowEndpointRequest, any>;
 type RawWebhookHandler = WebhookHandler<WebhookPayload>;
-type AccountUpdateHandler = WebhookHandler<ProcessedAccountUpdate>;
-type AccountReviewUpdateHandler = WebhookHandler<ProcessedAccountReviewUpdate>;
-type AccountAlertsHandler = WebhookHandler<ProcessedAccountAlerts>;
-type BusinessCapabilityUpdateHandler = WebhookHandler<ProcessedBusinessCapabilityUpdate>;
-type PhoneNumberNameUpdateHandler = WebhookHandler<ProcessedPhoneNumberNameUpdate>;
-type PhoneNumberQualityUpdateHandler = WebhookHandler<ProcessedPhoneNumberQualityUpdate>;
-type MessageTemplateStatusUpdateHandler = WebhookHandler<ProcessedMessageTemplateStatusUpdate>;
-type TemplateCategoryUpdateHandler = WebhookHandler<ProcessedTemplateCategoryUpdate>;
-type MessageTemplateQualityUpdateHandler = WebhookHandler<ProcessedMessageTemplateQualityUpdate>;
-type FlowsHandler = WebhookHandler<ProcessedFlows>;
-type SecurityHandler = WebhookHandler<ProcessedSecurity>;
-type HistoryHandler = WebhookHandler<ProcessedHistory>;
-type SmbMessageEchoesHandler = WebhookHandler<ProcessedSmbMessageEchoes>;
-type SmbAppStateSyncHandler = WebhookHandler<ProcessedSmbAppStateSync>;
-type AccountSettingsUpdateHandler = WebhookHandler<ProcessedAccountSettingsUpdate>;
-type AutomaticEventsHandler = WebhookHandler<ProcessedAutomaticEvents>;
-type BusinessStatusUpdateHandler = WebhookHandler<ProcessedBusinessStatusUpdate>;
-type BusinessUsernameUpdatesHandler = WebhookHandler<ProcessedBusinessUsernameUpdates>;
-type CallsHandler = WebhookHandler<ProcessedCalls>;
-type GroupLifecycleUpdateHandler = WebhookHandler<ProcessedGroupLifecycleUpdate>;
-type GroupParticipantsUpdateHandler = WebhookHandler<ProcessedGroupParticipantsUpdate>;
-type GroupSettingsUpdateHandler = WebhookHandler<ProcessedGroupSettingsUpdate>;
-type GroupStatusUpdateHandler = WebhookHandler<ProcessedGroupStatusUpdate>;
-type MessageEchoesHandler = WebhookHandler<ProcessedMessageEchoes>;
-type MessageTemplateComponentsUpdateHandler = WebhookHandler<ProcessedMessageTemplateComponentsUpdate>;
-type MessagingHandoversHandler = WebhookHandler<ProcessedMessagingHandovers>;
-type PartnerSolutionsHandler = WebhookHandler<ProcessedPartnerSolutions>;
-type PaymentConfigurationUpdateHandler = WebhookHandler<ProcessedPaymentConfigurationUpdate>;
-type StandbyHandler = WebhookHandler<ProcessedStandby>;
-type TemplateCorrectCategoryDetectionHandler = WebhookHandler<ProcessedTemplateCorrectCategoryDetection>;
-type TrackingEventsHandler = WebhookHandler<ProcessedTrackingEvents>;
-type UserPreferencesHandler = WebhookHandler<ProcessedUserPreferences>;
+/** Handler for a non-`messages` webhook field; `processed.value` is typed by the field name. */
+type WebhookFieldHandler<F extends NonMessageWebhookField> = WebhookHandler<ProcessedWebhookField<F>>;
+/** Registered field handlers keyed by field name, as kept by `WebhookProcessor`. */
+type WebhookFieldHandlerMap = ReadonlyMap<NonMessageWebhookField, AnyWebhookFieldHandler>;
+/**
+ * Field handler with the field type erased, for storage in a map. `on()`
+ * guarantees each stored handler matches its key.
+ */
+type AnyWebhookFieldHandler = WebhookHandler<{
+  wabaId: string;
+  value: any;
+}>;
+type AccountUpdateHandler = WebhookFieldHandler<'account_update'>;
+type AccountReviewUpdateHandler = WebhookFieldHandler<'account_review_update'>;
+type AccountAlertsHandler = WebhookFieldHandler<'account_alerts'>;
+type BusinessCapabilityUpdateHandler = WebhookFieldHandler<'business_capability_update'>;
+type PhoneNumberNameUpdateHandler = WebhookFieldHandler<'phone_number_name_update'>;
+type PhoneNumberQualityUpdateHandler = WebhookFieldHandler<'phone_number_quality_update'>;
+type MessageTemplateStatusUpdateHandler = WebhookFieldHandler<'message_template_status_update'>;
+type TemplateCategoryUpdateHandler = WebhookFieldHandler<'template_category_update'>;
+type MessageTemplateQualityUpdateHandler = WebhookFieldHandler<'message_template_quality_update'>;
+type FlowsHandler = WebhookFieldHandler<'flows'>;
+type SecurityHandler = WebhookFieldHandler<'security'>;
+type HistoryHandler = WebhookFieldHandler<'history'>;
+type SmbMessageEchoesHandler = WebhookFieldHandler<'smb_message_echoes'>;
+type SmbAppStateSyncHandler = WebhookFieldHandler<'smb_app_state_sync'>;
+type AccountSettingsUpdateHandler = WebhookFieldHandler<'account_settings_update'>;
+type AutomaticEventsHandler = WebhookFieldHandler<'automatic_events'>;
+type BusinessStatusUpdateHandler = WebhookFieldHandler<'business_status_update'>;
+type BusinessUsernameUpdatesHandler = WebhookFieldHandler<'business_username_updates'>;
+type CallsHandler = WebhookFieldHandler<'calls'>;
+type GroupLifecycleUpdateHandler = WebhookFieldHandler<'group_lifecycle_update'>;
+type GroupParticipantsUpdateHandler = WebhookFieldHandler<'group_participants_update'>;
+type GroupSettingsUpdateHandler = WebhookFieldHandler<'group_settings_update'>;
+type GroupStatusUpdateHandler = WebhookFieldHandler<'group_status_update'>;
+type MessageEchoesHandler = WebhookFieldHandler<'message_echoes'>;
+type MessageTemplateComponentsUpdateHandler = WebhookFieldHandler<'message_template_components_update'>;
+type MessagingHandoversHandler = WebhookFieldHandler<'messaging_handovers'>;
+type PartnerSolutionsHandler = WebhookFieldHandler<'partner_solutions'>;
+type PaymentConfigurationUpdateHandler = WebhookFieldHandler<'payment_configuration_update'>;
+type StandbyHandler = WebhookFieldHandler<'standby'>;
+type TemplateCorrectCategoryDetectionHandler = WebhookFieldHandler<'template_correct_category_detection'>;
+type TrackingEventsHandler = WebhookFieldHandler<'tracking_events'>;
+type UserPreferencesHandler = WebhookFieldHandler<'user_preferences'>;
 type TextMessageHandler = WebhookHandler<TextProcessedMessage>;
 type ImageMessageHandler = WebhookHandler<ImageProcessedMessage>;
 type VideoMessageHandler = WebhookHandler<VideoProcessedMessage>;
@@ -9291,16 +9480,11 @@ type ReactionMessageHandler = WebhookHandler<ReactionProcessedMessage>;
 type OrderMessageHandler = WebhookHandler<OrderProcessedMessage>;
 type SystemMessageHandler = WebhookHandler<SystemProcessedMessage>;
 /**
- * Process webhook messages
+ * Named handler options accepted by {@link processWebhookMessages}, one per
+ * webhook field except `messages`. Kept for backward compatibility; new code
+ * can pass `fieldHandlers` instead.
  */
-declare function processWebhookMessages(request: Request, whatsapp: WhatsApp, handlers: {
-  messageHandlers: Map<MessageTypesEnum, MessageHandler>;
-  statusHandler?: StatusHandler;
-  userActionHandler?: UserActionHandler;
-  preProcessHandler?: MessageHandler;
-  postProcessHandler?: MessageHandler;
-  rawHandler?: RawWebhookHandler;
-  rawHandlerFields?: WebhookFieldType[];
+type WebhookFieldHandlerOptions = {
   accountUpdateHandler?: AccountUpdateHandler;
   accountReviewUpdateHandler?: AccountReviewUpdateHandler;
   accountAlertsHandler?: AccountAlertsHandler;
@@ -9333,7 +9517,33 @@ declare function processWebhookMessages(request: Request, whatsapp: WhatsApp, ha
   templateCorrectCategoryDetectionHandler?: TemplateCorrectCategoryDetectionHandler;
   trackingEventsHandler?: TrackingEventsHandler;
   userPreferencesHandler?: UserPreferencesHandler;
-}, options?: WebhookSignatureOptions): Promise<Response>;
+};
+/** Dedupe settings for {@link processWebhookMessages}. */
+type WebhookDedupeOptions = {
+  store: DedupeStore; /** Defaults to 86400 (24 hours). */
+  ttlSeconds?: number;
+};
+/** Options for {@link processWebhookMessages}. */
+type ProcessWebhookOptions = WebhookSignatureOptions & {
+  /** Skip handlers for deliveries already seen. Duplicates still get a 200 response. */dedupe?: WebhookDedupeOptions;
+};
+/**
+ * Process webhook messages
+ */
+declare function processWebhookMessages(request: Request, whatsapp: WhatsApp, handlers: {
+  messageHandlers: Map<MessageTypesEnum, MessageHandler>;
+  statusHandler?: StatusHandler;
+  userActionHandler?: UserActionHandler;
+  preProcessHandler?: MessageHandler;
+  postProcessHandler?: MessageHandler;
+  rawHandler?: RawWebhookHandler;
+  rawHandlerFields?: WebhookFieldType[];
+  /**
+   * Handlers for non-`messages` fields keyed by field name. Takes
+   * precedence over the named `xxxHandler` option for the same field.
+   */
+  fieldHandlers?: WebhookFieldHandlerMap;
+} & WebhookFieldHandlerOptions, options?: ProcessWebhookOptions): Promise<Response>;
 /**
  * Handle flow requests
  */
@@ -9344,8 +9554,13 @@ type WebhookSignatureOptions = {
 };
 /**
  * Check an `X-Hub-Signature-256` header (`sha256=<hex>`) against the raw
- * request body. Constant-time; returns false instead of throwing on
- * malformed or wrong-length input.
+ * request body using Web Crypto, so it works on every runtime. Constant-time;
+ * resolves to false instead of throwing on malformed or wrong-length input.
+ */
+declare function verifyWebhookSignature(rawBody: string, signatureHeader: string | null, appSecret: string): Promise<boolean>;
+/**
+ * Synchronous variant of {@link verifyWebhookSignature}. Needs `node:crypto`
+ * (Node.js >= 20.12, Bun, Deno); prefer the async variant on edge runtimes.
  */
 declare function isValidWebhookSignature(rawBody: string, signatureHeader: string | null, appSecret: string): boolean;
 /**
@@ -9372,39 +9587,10 @@ declare class WebhookProcessor {
   private postProcessHandler;
   private rawHandler;
   private flowHandlers;
-  private accountUpdateHandler;
-  private accountReviewUpdateHandler;
-  private accountAlertsHandler;
-  private businessCapabilityUpdateHandler;
-  private phoneNumberNameUpdateHandler;
-  private phoneNumberQualityUpdateHandler;
-  private messageTemplateStatusUpdateHandler;
-  private templateCategoryUpdateHandler;
-  private messageTemplateQualityUpdateHandler;
-  private flowsHandler;
-  private securityHandler;
-  private historyHandler;
-  private smbMessageEchoesHandler;
-  private smbAppStateSyncHandler;
-  private accountSettingsUpdateHandler;
-  private automaticEventsHandler;
-  private businessStatusUpdateHandler;
-  private businessUsernameUpdatesHandler;
-  private callsHandler;
-  private groupLifecycleUpdateHandler;
-  private groupParticipantsUpdateHandler;
-  private groupSettingsUpdateHandler;
-  private groupStatusUpdateHandler;
-  private messageEchoesHandler;
-  private messageTemplateComponentsUpdateHandler;
-  private messagingHandoversHandler;
-  private partnerSolutionsHandler;
-  private paymentConfigurationUpdateHandler;
-  private standbyHandler;
-  private templateCorrectCategoryDetectionHandler;
-  private trackingEventsHandler;
-  private userPreferencesHandler;
+  /** Handlers for every webhook field except `messages`, keyed by field name. */
+  private fieldHandlers;
   private verifySignature;
+  private dedupe;
   constructor(config: WhatsAppConfig);
   processVerification(mode: string | null, token: string | null, challenge: string | null): Promise<WebhookResponse>;
   processWebhook(request: Request): Promise<WebhookResponse>;
@@ -9423,6 +9609,29 @@ declare class WebhookProcessor {
   onMessagePostProcess(handler: MessageHandler): void;
   onRaw(handler: RawWebhookHandler, fields?: WebhookFieldType[]): void;
   onFlow(type: FlowTypeEnum, handler: FlowHandler): void;
+  /**
+   * Register a handler for any webhook field except `messages`. The type of
+   * `processed.value` follows from the field name. Replaces any handler
+   * already registered for that field, including one set with the matching
+   * `onXxx` method (for example `onCalls` is `on('calls', handler)`).
+   *
+   * `messages` is not accepted: use `onMessage`, the typed message methods
+   * (`onText`, ...), `onStatus` or `onUserAction`, which split that field
+   * into messages, statuses and user actions.
+   *
+   * @example
+   * ```typescript
+   * processor.on('calls', async (whatsapp, { value }) => {
+   *     for (const call of value.calls) console.log(call.id, call.event);
+   * });
+   * ```
+   */
+  on<F extends NonMessageWebhookField>(field: F, handler: WebhookFieldHandler<F>): void;
+  /**
+   * Remove the handler for a webhook field registered with `on()` or the
+   * matching `onXxx` method. `messages` is not accepted (see {@link on}).
+   */
+  off(field: NonMessageWebhookField): void;
   /**
    * Register a handler for text messages
    * @param handler Type-safe handler that receives text messages with guaranteed text field
@@ -9720,26 +9929,108 @@ declare function expressWebhookHandler(config: ExpressWebhookConfig): {
   destroy: () => void;
 };
 //#endregion
-//#region src/core/webhook/frameworks/nextjs-app/nextjs-app.d.ts
-interface NextRequest extends Request {
-  nextUrl: {
-    searchParams: URLSearchParams;
+//#region src/core/webhook/frameworks/fastify/fastify.d.ts
+interface FastifyWebhookRequest {
+  method: string;
+  url: string;
+  headers: Record<string, string | string[] | undefined>;
+  body?: unknown;
+  query?: unknown;
+  /**
+   * The unparsed request body. Fastify does not keep it by default: set it in
+   * a content-type parser or with the `fastify-raw-body` plugin. Required for
+   * `verifyWebhookSignature: true`, because re-serializing the parsed body
+   * does not reproduce the bytes Meta signed.
+   */
+  rawBody?: string | Uint8Array;
+}
+interface FastifyWebhookReply {
+  code(statusCode: number): FastifyWebhookReply;
+  header(name: string, value: string): FastifyWebhookReply;
+  send(payload?: any): FastifyWebhookReply;
+}
+interface FastifyWebhookConfig extends WhatsAppConfig {}
+/** The object returned by {@link fastifyWebhookHandler}. */
+type FastifyWebhookHandlers = ReturnType<typeof createHandlers$2>;
+/**
+ * Fastify webhook handler.
+ *
+ * @example
+ * const wa = fastifyWebhookHandler(config);
+ * wa.processor.onText(async (whatsapp, { message }) => { ... });
+ * app.get('/webhook', wa.GET);
+ * app.post('/webhook', wa.POST);
+ * app.post('/flow', wa.flow);
+ */
+declare function fastifyWebhookHandler(config: FastifyWebhookConfig): FastifyWebhookHandlers;
+declare function createHandlers$2(config: FastifyWebhookConfig, key: string): {
+  GET: (request: FastifyWebhookRequest, reply: FastifyWebhookReply) => Promise<FastifyWebhookReply>;
+  POST: (request: FastifyWebhookRequest, reply: FastifyWebhookReply) => Promise<FastifyWebhookReply>;
+  webhook: (request: FastifyWebhookRequest, reply: FastifyWebhookReply) => Promise<FastifyWebhookReply>;
+  flow: (request: FastifyWebhookRequest, reply: FastifyWebhookReply) => Promise<FastifyWebhookReply>;
+  processor: WebhookProcessor;
+  /**
+   * Destroy this handler instance: removes all registered handlers
+   * and clears it from the singleton cache so the next call creates a fresh instance.
+   */
+  destroy: () => void;
+};
+//#endregion
+//#region src/core/webhook/frameworks/hono/hono.d.ts
+/**
+ * The part of Hono's `Context` this adapter uses, typed locally so `hono` is
+ * not a dependency. Any Hono `Context` satisfies it: `c.req.raw` is the
+ * underlying web `Request`.
+ */
+interface HonoWebhookContext {
+  req: {
+    raw: Request; /** Hono's cached body reader, used when middleware already consumed `raw`. */
+    text?: () => Promise<string>;
   };
 }
+interface HonoWebhookConfig extends WhatsAppConfig {}
+/** The object returned by {@link honoWebhookHandler}. */
+type HonoWebhookHandlers = ReturnType<typeof createHandlers$1>;
+/**
+ * Hono webhook handler. Works on every runtime Hono runs on (Node.js, Bun,
+ * Deno, Cloudflare Workers, Vercel Edge).
+ *
+ * @example
+ * const wa = honoWebhookHandler(config);
+ * wa.processor.onText(async (whatsapp, { message }) => { ... });
+ * app.get('/webhook', wa.GET);
+ * app.post('/webhook', wa.POST);
+ * app.post('/flow', wa.flow);
+ */
+declare function honoWebhookHandler(config: HonoWebhookConfig): HonoWebhookHandlers;
+declare function createHandlers$1(config: HonoWebhookConfig, key: string): {
+  GET: (c: HonoWebhookContext) => Promise<Response>;
+  POST: (c: HonoWebhookContext) => Promise<Response>;
+  webhook: (c: HonoWebhookContext) => Promise<Response>;
+  flow: (c: HonoWebhookContext) => Promise<Response>;
+  processor: WebhookProcessor;
+  /**
+   * Destroy this handler instance: removes all registered handlers
+   * and clears it from the singleton cache so the next call creates a fresh instance.
+   */
+  destroy: () => void;
+};
+//#endregion
+//#region src/core/webhook/frameworks/nextjs-app/nextjs-app.d.ts
 interface NextJsAppWebhookConfig extends WhatsAppConfig {}
 /** The object returned by {@link nextjsAppWebhookHandler}. */
 type NextJsAppWebhookHandlers = ReturnType<typeof createHandlers>;
 declare function nextjsAppWebhookHandler(config: NextJsAppWebhookConfig): NextJsAppWebhookHandlers;
 declare function createHandlers(config: NextJsAppWebhookConfig, key: string): {
-  GET: (request: NextRequest) => Promise<Response>;
-  POST: (request: NextRequest) => Promise<Response>;
+  GET: (request: Request) => Promise<Response>;
+  POST: (request: Request) => Promise<Response>;
   webhook: {
-    GET: (request: NextRequest) => Promise<Response>;
-    POST: (request: NextRequest) => Promise<Response>;
+    GET: (request: Request) => Promise<Response>;
+    POST: (request: Request) => Promise<Response>;
   };
   flow: {
-    GET: (request: NextRequest) => Promise<Response>;
-    POST: (request: NextRequest) => Promise<Response>;
+    GET: (request: Request) => Promise<Response>;
+    POST: (request: Request) => Promise<Response>;
   };
   processor: WebhookProcessor;
   /**
@@ -9798,7 +10089,14 @@ declare function nextjsPagesWebhookHandler<TRequest extends BaseApiRequest, TRes
 declare function extractMessageText(message: WhatsAppMessage): string;
 //#endregion
 //#region src/core/webhook/utils/generateXHub256Sig.d.ts
+/**
+ * Compute the hex HMAC-SHA256 that Meta sends in `X-Hub-Signature-256`
+ * (without the `sha256=` prefix). Needs `node:crypto`; use
+ * {@link generateXHub256SigAsync} on edge runtimes.
+ */
 declare const generateXHub256Sig: (body: string, appSecret: string) => string;
+/** Web Crypto variant of {@link generateXHub256Sig}; works on every runtime. */
+declare const generateXHub256SigAsync: (body: string, appSecret: string) => Promise<string>;
 //#endregion
 //#region src/core/webhook/utils/messageHelpers.d.ts
 declare function isTextMessage(msg: WhatsAppMessage): msg is TextMessage;
@@ -9920,16 +10218,136 @@ declare function buildFieldsQueryString(fields?: string[] | string): string;
  */
 declare function formatConfigTable(config: WabaConfigType): string;
 //#endregion
+//#region src/utils/customerServiceWindow.d.ts
+/**
+ * Length of the customer service window: 24 hours.
+ *
+ * "When a WhatsApp user messages you or calls you, a 24-hour timer called a customer service window
+ * starts. If the user messages or calls you again before the timer expires, the timer resets to
+ * 24 hours. [...] When the window closes, you can only send pre-approved template messages."
+ *
+ * @see {@link https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages/ | Send messages: customer service windows}
+ */
+declare const CUSTOMER_SERVICE_WINDOW_MS: number;
+/**
+ * SDK fallback length of a free entry point (FEP) window: 72 hours.
+ * Prefer the expiry supplied by Meta; this fallback does not establish billing eligibility.
+ *
+ * @see {@link https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/ | Pricing: free entry point windows}
+ */
+declare const FREE_ENTRY_POINT_WINDOW_MS: number;
+/**
+ * Longest free entry point window Meta documents: up to 7 days for conversations started from an
+ * ad that clicks to WhatsApp.
+ *
+ * @see {@link https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/ | Pricing: free entry point windows}
+ */
+declare const MAX_FREE_ENTRY_POINT_WINDOW_MS: number;
+/**
+ * A point in time accepted by the window helpers:
+ * - `Date`
+ * - `number`: Unix epoch in milliseconds, or in seconds when below `1e11` (before the year 5138 in
+ *   seconds, before March 1973 in milliseconds), so both `Date.now()` and webhook timestamps work
+ * - `string`: a numeric string such as the webhook `messages[].timestamp` (`"1727856000"`, Unix
+ *   seconds, same rule as numbers), or any string `Date.parse` understands (ISO 8601)
+ */
+type WindowTimestamp = Date | number | string;
+/** State of a messaging window at a given instant. */
+interface MessagingWindow {
+  /** True while the window is open (`now < expiresAt`). */
+  isOpen: boolean;
+  /** When the window closes, or `null` when there is no window (no inbound message yet). */
+  expiresAt: Date | null;
+  /** Milliseconds until the window closes, `0` once closed. Never more than the window length. */
+  remainingMs: number;
+}
+interface CustomerServiceWindowOptions {
+  /** The instant to evaluate. Defaults to `Date.now()`. */
+  now?: WindowTimestamp;
+  /**
+   * Treat the window as closing this many milliseconds early. Use it to absorb clock drift between
+   * your servers and Meta and the time a send spends in flight. Defaults to `0`.
+   */
+  safetyMarginMs?: number;
+}
+interface FreeEntryPointWindowOptions extends CustomerServiceWindowOptions {
+  /**
+   * Window length. Defaults to {@link FREE_ENTRY_POINT_WINDOW_MS} (72 hours). Meta may keep a
+   * click-to-WhatsApp ad window open for up to {@link MAX_FREE_ENTRY_POINT_WINDOW_MS} (7 days)
+   * without saying how long a given window lasts, so prefer `expiresAt` when you have it.
+   */
+  durationMs?: number;
+  /**
+   * Exact expiry when known, for example the status webhook's `conversation.expiration_timestamp`
+   * (Unix seconds). Overrides `durationMs`.
+   */
+  expiresAt?: WindowTimestamp;
+}
+/**
+ * Returns the state of the 24-hour customer service window opened by the user's last inbound
+ * message (or call).
+ *
+ * Free-form (non-template) messages can only be sent while it is open; outside it only approved
+ * template messages are delivered (Meta rejects others with error `131047`). The window is exactly
+ * 24 hours from the user's last message: at `lastInboundAt + 24h` it is closed.
+ *
+ * Pass the webhook message `timestamp` (Unix seconds string) of the latest message from the user.
+ * Messages you send do not extend the window. Pass `null`/`undefined` when the user has never
+ * messaged you; that returns a closed window with `expiresAt: null`.
+ *
+ * A free entry point window does not reopen this window: "the customer service window is independent
+ * of the FEP window, so if the customer service window closes, you will only be able to send template
+ * messages." Use {@link getFreeEntryPointWindow} for the pricing side.
+ *
+ * @throws WhatsAppValidationError when a timestamp or `safetyMarginMs` is malformed.
+ *
+ * @see {@link https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages/ | Send messages: customer service windows}
+ * @see {@link https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/ | Pricing}
+ *
+ * @example
+ * ```ts
+ * const { isOpen, expiresAt } = getCustomerServiceWindow(message.timestamp);
+ * if (!isOpen) await sendTemplateInstead();
+ * ```
+ */
+declare function getCustomerServiceWindow(lastInboundAt: WindowTimestamp | null | undefined, options?: CustomerServiceWindowOptions): MessagingWindow;
+/**
+ * True when a free-form (non-template) message can be sent: the customer service window opened by
+ * the user's last inbound message is still open. See {@link getCustomerServiceWindow}.
+ *
+ * @throws WhatsAppValidationError when a timestamp or `safetyMarginMs` is malformed.
+ */
+declare function canSendFreeformMessage(lastInboundAt: WindowTimestamp | null | undefined, options?: CustomerServiceWindowOptions): boolean;
+/**
+ * Returns the state of a free entry point (FEP) window.
+ *
+ * For eligible click-to-WhatsApp ad traffic, replying within the customer service window opens
+ * a billing window from the time of your reply. Pass that first reply time as `openedAt`.
+ *
+ * Meta documents windows lasting up to 7 days for ads that click to WhatsApp. This helper uses
+ * a 72-hour fallback estimate. Pass `expiresAt` (the status webhook's
+ * `conversation.expiration_timestamp`) when you have it, or set `durationMs`.
+ *
+ * This is a billing window only. It does not allow free-form messages after the customer service
+ * window closes; check {@link canSendFreeformMessage} for that.
+ *
+ * @throws WhatsAppValidationError when a timestamp, `durationMs` or `safetyMarginMs` is malformed.
+ *
+ * @see {@link https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/ | Pricing: free entry point windows}
+ */
+declare function getFreeEntryPointWindow(openedAt: WindowTimestamp | null | undefined, options?: FreeEntryPointWindowOptions): MessagingWindow;
+//#endregion
 //#region src/utils/logger.d.ts
 declare class Logger implements LoggerInterface {
   private name;
-  private debug;
+  private debugEnabled;
   constructor(name: string, debug?: boolean);
   private formatData;
   log(...data: any[]): void;
   error(...data: any[]): void;
   warn(...data: any[]): void;
   info(...data: any[]): void;
+  debug(...data: any[]): void;
 }
 //#endregion
 //#region src/utils/objectToQueryString.d.ts
@@ -9976,5 +10394,5 @@ declare function isFlowErrorRequest(request: FlowEndpointRequest): request is Fl
  */
 declare function isFlowPingRequest(request: FlowEndpointRequest): request is FlowHealthCheckRequest;
 //#endregion
-export { AUTHORIZATION_ERROR_CODES, type AcceptCallRequest, AcceptSolutionRequest, AccountMode, AddPhoneNumbersRequest, type ApiPermissionErrorCode, AssignedUserRequest, AssignedUsersListParams, type AudioMediaObject, AudioMediaTypes, AudioMediaTypesEnum, AudioMediaTypesType, type AudioMessage, type AudioMessageHandler, type AudioProcessedMessage, type AuthenticationTemplateOptions, BLOCK_USER_ERROR_CODES, type BaseApiRequest, type BaseApiResponse, type BaseClass, BlockUserObject, BlockUsersApi, BlockUsersClass, BlockUsersRequest, BlockUsersResponse, BlockedUserInfo, type BodyOptions, BusinessApi, BusinessClass, BusinessComplianceInfoResponse, BusinessFieldsParam, BusinessGraphListResponse, BusinessGraphObject, BusinessListParams, BusinessProfileApi, type BusinessProfileClass, type BusinessProfileData, type BusinessProfileField, type BusinessProfileFieldsParam, type BusinessProfileResponse, BusinessVerticalEnum, type ButtonMessage, type ButtonMessageHandler, type ButtonOptions, ButtonPosition, ButtonPositionEnum, ButtonPositionType, type ButtonProcessedMessage, CALLING_ERROR_CODES, type CallAction, type CallActionResponse, type CallAnnouncementLanguage, type CallCaptureStatus, type CallHours, type CallHoursDay, type CallHoursStatus, type CallIconVisibility, type CallPermission, type CallPermissionAction, type CallPermissionLimit, type CallPermissionsResponse, type CallRecordingConfig, type CallSdpType, type CallSession, type CallTranscriptionConfig, type CallbackPermissionStatus, CallingApi, type CallingClass, type CallingSettings, type CallingSettingsResponse, type CallingStatus, CarouselCard, type CarouselOptions, CatalogButton, type CatalogTemplateOptions, Category, CategoryEnum, CategoryType, CodeVerificationStatus, CommerceApi, type CommerceClass, type CommerceSetting, type CommerceSettingsResponse, ComponentType, ComponentTypeType, ComponentTypes, ComponentTypesEnum, ContactBookApi, ContactBookClass, type ContactInfo, type ContactObject, type ContactsMessage, type ContactsMessageHandler, type ContactsProcessedMessage, ConversationTypes, ConversationTypesEnum, ConversationTypesType, ConversationalAutomationRequest, ConversationalAutomationResponse, ConversationalCommand, ConversationalPrompt, CopyCodeButton, type CouponTemplateOptions, type CreateFlowResponse, CreateOBOMobilityIntentRequest, CreatePhoneNumberRequest, CreatePhoneNumberResponse, type CreateQrCodeRequest, CreateScheduleRequest, type CreateUploadSessionParams, CreateWhatsAppBusinessSolutionRequest, CurrencyCodesEnum, type CurrencyParameter, CursorPaginationParams, Cursors, DataLocalizationRegion, DataLocalizationRegionEnum, DataLocalizationRegionType, type DateTimeParameter, DeleteContactBookEntryParams, DeleteContactBookEntryResponse, type DirectSendCategory, type DirectSendConfig, type DirectSendOptions, type DocumentMediaObject, DocumentMediaTypes, DocumentMediaTypesEnum, DocumentMediaTypesType, type DocumentMessage, type DocumentMessageHandler, type DocumentProcessedMessage, type EncryptedMessageRequest, type EncryptedMessagesResponse, EncryptionApi, type EncryptionClass, type EncryptionKeyPair, type EncryptionPublicKeyResponse, type ErrorWebhookValue, type ExpressRequest, type ExpressResponse, type ExpressWebhookConfig, FLOW_ERROR_CODES, FailedUserInfo, type Flow, FlowActionEnum, FlowApi, type FlowAsset, type FlowAssetsResponse, FlowButton, FlowCategoryEnum, type FlowClass, type FlowDataExchangeRequest, type FlowDataExchangeResponse, type FlowDecryptedRequestResponse, type FlowEncryptedRequestPayload, type FlowEndpointRequest, type FlowEndpointResponse, type FlowErrorNotificationRequest, type FlowErrorNotificationResponse, type FlowHandler, 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, GROUP_ERROR_CODES, type GeneralHeaderInterface, type GeneralMessageBody, type GeneralRequestBody, type GetUploadHandleParams, GraphObject, type GroupCreateRequest, type GroupCreateResponse, type GroupInfoField, type GroupInfoFieldsParam, type GroupInfoResponse, type GroupInviteLinkResponse, type GroupJoinApprovalMode, type GroupJoinRequest, type GroupJoinRequestError, type GroupJoinRequestFailure, type GroupJoinRequestsActionResponse, type GroupJoinRequestsResponse, type GroupListParams, type GroupListResponse, type GroupMessage, type GroupParticipant, type GroupParticipantInput, type GroupParticipantsRequest, type GroupSettingsResponse, GroupsApi, type GroupsClass, type HeaderOptions, HealthStatus, HealthStatusEntity, type HolidaySchedule, HostPlatform, HttpMethods, HttpMethodsEnum, HttpMethodsType, type HttpsClientClass, type HttpsClientResponseClass, INTEGRITY_ERROR_CODES, type ImageMediaObject, ImageMediaTypes, ImageMediaTypesEnum, ImageMediaTypesType, type ImageMessage, type ImageMessageHandler, type ImageProcessedMessage, type InitiateCallRequest, type InitiateCallResponse, type InteractiveButtonReplyMessage, type InteractiveListReplyMessage, type InteractiveMessage, type InteractiveMessageHandler, type InteractiveObject, type InteractiveProcessedMessage, type InteractiveReply, InteractiveTypes, InteractiveTypesEnum, InteractiveTypesType, Languages, LanguagesEnum, LanguagesType, type LimitedTimeOfferOptions, type LimitedTimeOfferTemplateOptions, ListBlockedUsersParams, ListBlockedUsersResponse, type LocationInfo, type LocationMessage, type LocationMessageHandler, type LocationObject, type LocationParameter, type LocationProcessedMessage, Logger, type LoggerInterface, MPMButton, type MPMTemplateOptions, type MarketingMessageBidSpec, type MarketingMessageRequest, MarketingMessagesApi, type MarketingMessagesClass, type MarketingMessagesLinkClickData, MediaApi, type MediaCardCarouselTemplateOptions, MediaCarouselCard, MediaClass, type MediaInfo, type MediaParameter, MediaResponse, MediasResponse, MessagesApi as MessageApi, MessagesApi, MessageCategory, MessageCategoryEnum, MessageCategoryType, type MessageHandler, MessageHistoryApi, MessageHistoryClass, MessageHistoryEventListParams, MessageHistoryFieldsParam, MessageHistoryItem, MessageHistoryListParams, MessageHistoryResponse, type MessageRecipientType, type MessageRequestBody, type MessageRequestParams, type MessageStatus, MessageTemplateObject, MessageTemplateRequestBody, MessageTypes, MessageTypesEnum, MessageTypesType, type MessageWebhookValue, type MessagesClass, type MessagesResponse, MessagingLimitTier, type MetaError, type MetaErrorData, type MetaErrorDetail, type NextFunction, type NextJsAppWebhookConfig, type NextJsAppWebhookHandlers, type NextJsWebhookConfig, OTPButton, type OTPTemplateOptions, OfficialBusinessAccountAction, OfficialBusinessAccountApplicationData, OfficialBusinessAccountStatusResponse, OnboardPartnersToMMLiteRequest, type OrderInfo, type OrderMessage, type OrderMessageHandler, type OrderProcessedMessage, type Pagination, type PaginationCursors, type Paging, PagingCursors, PagingInfo, ParametersTypes, ParametersTypesEnum, ParametersTypesType, PassThreadControlParams, type PaymentConfiguration, type PaymentConfigurationCode, type PaymentConfigurationCreateRequest, type PaymentConfigurationCreateResponse, type PaymentConfigurationDeleteRequest, type PaymentConfigurationOauthLinkRequest, type PaymentConfigurationOauthLinkResponse, type PaymentConfigurationProvider, type PaymentConfigurationStatus, type PaymentConfigurationUpdateRequest, type PaymentConfigurationUpdateResponse, type PaymentConfigurationsResponse, PaymentsApi, type PaymentsClass, PhoneNumberApi, PhoneNumberButton, PhoneNumberClass, PhoneNumberField, PhoneNumberFieldsParam, PhoneNumberFilter, PhoneNumberResponse, PhoneNumberSettingsFieldsParam, PhoneNumberSettingsParams, PhoneNumberSettingsResponse, PhoneNumberSort, PhoneNumberStatus, PhoneNumbersListParams, PhoneNumbersResponse, PlatformType, type PreAcceptCallRequest, type ProcessedMessage, type ProcessedStatus, type ProcessedUserAction, type ProductCardCarouselTemplateOptions, ProductCarouselCard, type ProductParameter, type ProductSection, QrCodeApi, type QrCodeClass, type QrCodeResponse, type QrCodesResponse, QualityRating, QualityScore, QuickReplyButton, type ReactionInfo, type ReactionMessage, type ReactionMessageHandler, type ReactionParams, type ReactionProcessedMessage, ReferralSourceTypes, ReferralSourceTypesEnum, ReferralSourceTypesType, RegistrationApi, type RegistrationClass, type RegistrationRequest, type RejectCallRequest, RejectSolutionRequest, ReleaseThreadControlParams, RemoveAssignedUserRequest, RequestCodeMethods, RequestCodeMethodsEnum, RequestCodeMethodsType, RequestPreVerifiedPhoneNumberCodeRequest, RequestVerificationCodeRequest, type RequesterClass, type RequesterResponseInterface, type ResponseData, type ResponseHeaderValue, type ResponseHeaders, type ResponseJSONBody, type ResponsePagination, type ResponseSuccess, SEND_MESSAGE_ERROR_CODES, SPMButton, type SPMTemplateOptions, SetOBOMobilityIntentRequest, SetSolutionMigrationIntentRequest, SharePreVerifiedPhoneNumberRequest, type SipServer, type SipSettings, type SipStatus, SolutionDeactivationRequest, SolutionFieldsParam, SolutionGraphObject, SolutionListParams, SolutionListResponse, SolutionMigrationIntent, SolutionsApi, SolutionsClass, Status, StatusEnum, type StatusHandler, type StatusParams, type StatusResponse, StatusType, type StatusWebhook, type StatusWebhookValue, type StickerMediaObject, StickerMediaTypes, StickerMediaTypesEnum, StickerMediaTypesType, type StickerMessage, type StickerMessageHandler, type StickerProcessedMessage, SubType, SubTypeEnum, SubTypeType, SystemChangeTypes, SystemChangeTypesEnum, SystemChangeTypesType, type SystemMessage, type SystemMessageHandler, type SystemProcessedMessage, THROTTLING_ERROR_CODES, TakeThreadControlParams, TemplateApi, TemplateBidSpec, TemplateBody, TemplateButton, TemplateButtons, TemplateCarousel, TemplateClass, TemplateDeleteParams, TemplateFooter, TemplateFormat, TemplateGetParams, TemplateHeader, TemplateHeaderExample, TemplateLimitedTimeOffer, TemplateOptimizationSpec, type TemplateOptions, type TemplateParameter, TemplateRequestBody, TemplateResponse, TemplateStatus, TemplateStatusEnum, TemplateStatusType, type TerminateCallRequest, type TextMessage, type TextMessageHandler, type TextMessageParams, type TextObject, type TextParameter, type TextProcessedMessage, ThreadControlApi, ThreadControlBaseParams, ThreadControlClass, ThreadControlResponse, ThreadControlRole, ThreadControlUserIdentifier, Throughput, ThroughputLevel, ThroughputResponse, TwoStepVerificationApi, type TwoStepVerificationClass, TwoStepVerificationParams, type TwoStepVerificationRequest, URLButton, UnblockUsersRequest, UnifiedCertStatus, type UnsupportedMessage, UpdateBusinessComplianceInfoRequest, type UpdateBusinessProfileRequest, type UpdateCallingSettingsRequest, type UpdateCommerceSettingsRequest, type UpdateFlowResponse, type UpdateGroupSettingsRequest, UpdateOfficialBusinessAccountStatusRequest, UpdatePhoneNumberSettingsRequest, UpdatePhoneNumberStatusRequest, type UpdateQrCodeRequest, UpdateUsernameRequest, UpdateWabaAccountRequest, UpdateWabaSubscription, UpdateWhatsAppBusinessProfileRequest, type UploadBusinessProfileResponse, type UploadHandle, type UploadMediaParams, UploadMediaResponse, type UploadSession, type UploadSessionResponse, type UserAction, type UserActionHandler, type UserActionType, type UserActionsWebhookValue, UsernameResponse, UsernameStatus, UsernameSuggestionsResponse, UsernameTransferAction, type ValidateFlowJsonResponse, VerifyCodeRequest, VerifyPreVerifiedPhoneNumberCodeRequest, type VideoMediaObject, VideoMediaTypes, VideoMediaTypesEnum, VideoMediaTypesType, type VideoMessage, type VideoMessageHandler, type VideoProcessedMessage, WABAClass, WHATSAPP_ERROR_CODES, WabaAccount, WabaAccountFields, WabaAccountFieldsParam, WabaAccountReviewStatus, WabaAccountStatus, WabaApi, WabaBusinessVerificationStatus, WabaConfigEnum, type WabaConfigType, WabaFieldsParam, WabaGraphObject, WabaHealthStatus, WabaHealthStatusCanSendMessage, WabaHealthStatusEntity, WabaHealthStatusError, WabaListParams, WabaListResponse, WabaSubscription, WabaSubscriptions, type WebhookContact, type WebhookEvent, type WebhookHandlerContext, type WebhookMessage, type WebhookPayload, WebhookProcessor, type WebhookResponse, type WebhookSignatureOptions, WebhookTypes, WebhookTypesEnum, WebhookTypesType, type WebhookValue, type WeeklyOperatingHours, WhatsApp, WhatsApp as default, WhatsAppApiError, WhatsAppAuthorizationError, WhatsAppBlockUserError, WhatsAppCallingError, type WhatsAppConfig, WhatsAppError, type WhatsAppErrorCode, WhatsAppFlowError, WhatsAppGroupError, WhatsAppIntegrityError, type WhatsAppMessage, WhatsAppNetworkError, WhatsAppSendMessageError, WhatsAppThrottlingError, WhatsAppUnknownError, WhatsAppValidationError, buildFieldsQueryString, constructFullUrl, createAuthenticationTemplate, createCatalogTemplate, createCouponTemplate, createLimitedTimeOfferTemplate, createMPMTemplate, createMediaCardCarouselTemplate, createOTPTemplate, createProductCardCarouselTemplate, createSPMTemplate, createTemplate, createWhatsAppApiError, decryptFlowRequest, encryptFlowResponse, expressWebhookHandler, extractMessageText, formatConfigTable, generateEncryption, generateXHub256Sig, getContactsInfo, getInteractiveReply, getLocationInfo, getMediaInfo, getOrderInfo, getReactionInfo, isApiPermissionErrorCode, isAudioMessage, isAuthorizationErrorCode, isBlockUserErrorCode, isButtonMessage, isButtonReply, isCallingErrorCode, isContactsMessage, isDocumentMessage, isFlowDataExchangeRequest, isFlowErrorCode, isFlowErrorRequest, isFlowPingRequest, isGroupErrorCode, isImageMessage, isIntegrityErrorCode, isInteractiveMessage, isListReply, isLocationMessage, isMetaError, isNfmReply, isOrderMessage, isReactionMessage, isSendMessageErrorCode, isStickerMessage, isSystemMessage, isTextMessage, isThrottlingErrorCode, isValidWebhookSignature, isVideoMessage, isWhatsAppApiErrorResponse, isWhatsAppAuthorizationError, isWhatsAppBlockUserError, isWhatsAppCallingError, isWhatsAppErrorCode, isWhatsAppFlowError, isWhatsAppGroupError, isWhatsAppIntegrityError, isWhatsAppSendMessageError, isWhatsAppThrottlingError, nextjsAppWebhookHandler, nextjsPagesWebhookHandler, normalizeMetaError, objectToQueryString, processFlowRequest, processWebhookMessages };
+export { AUTHORIZATION_ERROR_CODES, type AcceptCallRequest, AcceptSolutionRequest, AccountMode, AddPhoneNumbersRequest, type ApiPermissionErrorCode, AssignedUserRequest, AssignedUsersListParams, type AudioMediaObject, AudioMediaTypes, AudioMediaTypesEnum, AudioMediaTypesType, type AudioMessage, type AudioMessageHandler, type AudioProcessedMessage, type AuthenticationTemplateOptions, BLOCK_USER_ERROR_CODES, type BaseApiRequest, type BaseApiResponse, type BaseClass, BlockUserObject, BlockUsersApi, BlockUsersClass, BlockUsersRequest, BlockUsersResponse, BlockedUserInfo, type BodyOptions, BusinessApi, BusinessClass, BusinessComplianceInfoResponse, BusinessFieldsParam, BusinessGraphListResponse, BusinessGraphObject, BusinessListParams, BusinessProfileApi, type BusinessProfileClass, type BusinessProfileData, type BusinessProfileField, type BusinessProfileFieldsParam, type BusinessProfileResponse, type BusinessUseCaseUsage, BusinessVerticalEnum, type ButtonMessage, type ButtonMessageHandler, type ButtonOptions, ButtonPosition, ButtonPositionEnum, ButtonPositionType, type ButtonProcessedMessage, CALLING_ERROR_CODES, CUSTOMER_SERVICE_WINDOW_MS, type CallAction, type CallActionResponse, type CallAnnouncementLanguage, type CallCaptureStatus, type CallHours, type CallHoursDay, type CallHoursStatus, type CallIconVisibility, type CallPermission, type CallPermissionAction, type CallPermissionLimit, type CallPermissionsResponse, type CallRecordingConfig, type CallSdpType, type CallSession, type CallTranscriptionConfig, type CallbackPermissionStatus, CallingApi, type CallingClass, type CallingSettings, type CallingSettingsResponse, type CallingStatus, CarouselCard, type CarouselOptions, CatalogButton, type CatalogTemplateOptions, Category, CategoryEnum, CategoryType, CodeVerificationStatus, CommerceApi, type CommerceClass, type CommerceSetting, type CommerceSettingsResponse, ComponentType, ComponentTypeType, ComponentTypes, ComponentTypesEnum, ContactBookApi, ContactBookClass, type ContactInfo, type ContactObject, type ContactsMessage, type ContactsMessageHandler, type ContactsProcessedMessage, ConversationTypes, ConversationTypesEnum, ConversationTypesType, ConversationalAutomationRequest, ConversationalAutomationResponse, ConversationalCommand, ConversationalPrompt, CopyCodeButton, type CouponTemplateOptions, type CreateFlowResponse, CreateOBOMobilityIntentRequest, CreatePhoneNumberRequest, CreatePhoneNumberResponse, type CreateQrCodeRequest, CreateScheduleRequest, type CreateUploadSessionParams, CreateWhatsAppBusinessSolutionRequest, CurrencyCodesEnum, type CurrencyParameter, CursorPaginationParams, Cursors, type CustomerServiceWindowOptions, DataLocalizationRegion, DataLocalizationRegionEnum, DataLocalizationRegionType, type DateTimeParameter, type DecryptedFlowRequest, type DedupeStore, DeleteContactBookEntryParams, DeleteContactBookEntryResponse, type DirectSendCategory, type DirectSendConfig, type DirectSendOptions, type DocumentMediaObject, DocumentMediaTypes, DocumentMediaTypesEnum, DocumentMediaTypesType, type DocumentMessage, type DocumentMessageHandler, type DocumentProcessedMessage, type EncryptedMessageRequest, type EncryptedMessagesResponse, EncryptionApi, type EncryptionClass, type EncryptionKeyPair, type EncryptionPublicKeyResponse, type ErrorWebhookValue, type ExpressRequest, type ExpressResponse, type ExpressWebhookConfig, FLOW_ERROR_CODES, FREE_ENTRY_POINT_WINDOW_MS, FailedUserInfo, type FastifyWebhookConfig, type FastifyWebhookHandlers, type FastifyWebhookReply, type FastifyWebhookRequest, type Flow, FlowActionEnum, FlowApi, type FlowAsset, type FlowAssetsResponse, FlowButton, FlowCategoryEnum, type FlowClass, type FlowDataExchangeRequest, type FlowDataExchangeResponse, type FlowDecryptedRequestResponse, type FlowEncryptedRequestPayload, type FlowEndpointRequest, type FlowEndpointResponse, type FlowErrorNotificationRequest, type FlowErrorNotificationResponse, type FlowHandler, 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 FreeEntryPointWindowOptions, GROUP_ERROR_CODES, type GeneralHeaderInterface, type GeneralMessageBody, type GeneralRequestBody, type GetUploadHandleParams, GraphObject, type GroupCreateRequest, type GroupCreateResponse, type GroupInfoField, type GroupInfoFieldsParam, type GroupInfoResponse, type GroupInviteLinkResponse, type GroupJoinApprovalMode, type GroupJoinRequest, type GroupJoinRequestError, type GroupJoinRequestFailure, type GroupJoinRequestsActionResponse, type GroupJoinRequestsResponse, type GroupListParams, type GroupListResponse, type GroupMessage, type GroupParticipant, type GroupParticipantInput, type GroupParticipantsRequest, type GroupSettingsResponse, GroupsApi, type GroupsClass, type HeaderOptions, HealthStatus, HealthStatusEntity, type HolidaySchedule, type HonoWebhookConfig, type HonoWebhookContext, type HonoWebhookHandlers, HostPlatform, HttpMethods, HttpMethodsEnum, HttpMethodsType, type HttpsClientClass, type HttpsClientResponseClass, INTEGRITY_ERROR_CODES, type ImageMediaObject, ImageMediaTypes, ImageMediaTypesEnum, ImageMediaTypesType, type ImageMessage, type ImageMessageHandler, type ImageProcessedMessage, type InitiateCallRequest, type InitiateCallResponse, type InteractiveButtonReplyMessage, type InteractiveListReplyMessage, type InteractiveMessage, type InteractiveMessageHandler, type InteractiveObject, type InteractiveProcessedMessage, type InteractiveReply, InteractiveTypes, InteractiveTypesEnum, InteractiveTypesType, Languages, LanguagesEnum, LanguagesType, type LimitedTimeOfferOptions, type LimitedTimeOfferTemplateOptions, ListBlockedUsersParams, ListBlockedUsersResponse, type LocationInfo, type LocationMessage, type LocationMessageHandler, type LocationObject, type LocationParameter, type LocationProcessedMessage, Logger, type LoggerInterface, MAX_FREE_ENTRY_POINT_WINDOW_MS, MPMButton, type MPMTemplateOptions, type MarketingMessageBidSpec, type MarketingMessageRequest, MarketingMessagesApi, type MarketingMessagesClass, type MarketingMessagesLinkClickData, MediaApi, type MediaCardCarouselTemplateOptions, MediaCarouselCard, MediaClass, type MediaInfo, type MediaParameter, MediaResponse, MediasResponse, MemoryDedupeStore, type MemoryDedupeStoreOptions, MessagesApi as MessageApi, MessagesApi, MessageCategory, MessageCategoryEnum, MessageCategoryType, type MessageHandler, MessageHistoryApi, MessageHistoryClass, MessageHistoryEventListParams, MessageHistoryFieldsParam, MessageHistoryItem, MessageHistoryListParams, MessageHistoryResponse, type MessageRecipientType, type MessageRequestBody, type MessageRequestParams, type MessageStatus, MessageTemplateObject, MessageTemplateRequestBody, MessageTypes, MessageTypesEnum, MessageTypesType, type MessageWebhookValue, type MessagesClass, type MessagesResponse, MessagingLimitTier, type MessagingWindow, type MetaError, type MetaErrorData, type MetaErrorDetail, type NextFunction, type NextJsAppWebhookConfig, type NextJsAppWebhookHandlers, type NextJsWebhookConfig, type NonMessageWebhookField, OTPButton, type OTPTemplateOptions, OfficialBusinessAccountAction, OfficialBusinessAccountApplicationData, OfficialBusinessAccountStatusResponse, OnboardPartnersToMMLiteRequest, type OrderInfo, type OrderMessage, type OrderMessageHandler, type OrderProcessedMessage, type Pagination, type PaginationCursors, type Paging, PagingCursors, PagingInfo, ParametersTypes, ParametersTypesEnum, ParametersTypesType, PassThreadControlParams, type PaymentConfiguration, type PaymentConfigurationCode, type PaymentConfigurationCreateRequest, type PaymentConfigurationCreateResponse, type PaymentConfigurationDeleteRequest, type PaymentConfigurationOauthLinkRequest, type PaymentConfigurationOauthLinkResponse, type PaymentConfigurationProvider, type PaymentConfigurationStatus, type PaymentConfigurationUpdateRequest, type PaymentConfigurationUpdateResponse, type PaymentConfigurationsResponse, PaymentsApi, type PaymentsClass, PhoneNumberApi, PhoneNumberButton, PhoneNumberClass, PhoneNumberField, PhoneNumberFieldsParam, PhoneNumberFilter, PhoneNumberResponse, PhoneNumberSettingsFieldsParam, PhoneNumberSettingsParams, PhoneNumberSettingsResponse, PhoneNumberSort, PhoneNumberStatus, PhoneNumbersListParams, PhoneNumbersResponse, PlatformType, type PreAcceptCallRequest, type ProcessWebhookOptions, type ProcessedMessage, type ProcessedStatus, type ProcessedUserAction, type ProcessedWebhookField, type ProductCardCarouselTemplateOptions, ProductCarouselCard, type ProductParameter, type ProductSection, QrCodeApi, type QrCodeClass, type QrCodeResponse, type QrCodesResponse, QualityRating, QualityScore, QuickReplyButton, type RateLimitHeadersInput, type RateLimitInfo, type RateLimitInfoContext, type RateLimitInfoListener, type RateLimitUsage, type ReactionInfo, type ReactionMessage, type ReactionMessageHandler, type ReactionParams, type ReactionProcessedMessage, ReferralSourceTypes, ReferralSourceTypesEnum, ReferralSourceTypesType, RegistrationApi, type RegistrationClass, type RegistrationRequest, type RejectCallRequest, RejectSolutionRequest, ReleaseThreadControlParams, RemoveAssignedUserRequest, RequestCodeMethods, RequestCodeMethodsEnum, RequestCodeMethodsType, RequestPreVerifiedPhoneNumberCodeRequest, RequestVerificationCodeRequest, type RequesterClass, type RequesterResponseInterface, type ResponseData, type ResponseHeaderValue, type ResponseHeaders, type ResponseJSONBody, type ResponsePagination, type ResponseSuccess, type RetryConfig, SEND_MESSAGE_ERROR_CODES, SPMButton, type SPMTemplateOptions, SetOBOMobilityIntentRequest, SetSolutionMigrationIntentRequest, SharePreVerifiedPhoneNumberRequest, type SipServer, type SipSettings, type SipStatus, SolutionDeactivationRequest, SolutionFieldsParam, SolutionGraphObject, SolutionListParams, SolutionListResponse, SolutionMigrationIntent, SolutionsApi, SolutionsClass, Status, StatusEnum, type StatusHandler, type StatusParams, type StatusResponse, StatusType, type StatusWebhook, type StatusWebhookValue, type StickerMediaObject, StickerMediaTypes, StickerMediaTypesEnum, StickerMediaTypesType, type StickerMessage, type StickerMessageHandler, type StickerProcessedMessage, SubType, SubTypeEnum, SubTypeType, SystemChangeTypes, SystemChangeTypesEnum, SystemChangeTypesType, type SystemMessage, type SystemMessageHandler, type SystemProcessedMessage, THROTTLING_ERROR_CODES, TakeThreadControlParams, TemplateApi, TemplateBidSpec, TemplateBody, TemplateButton, TemplateButtons, TemplateCarousel, TemplateClass, TemplateDeleteParams, TemplateFooter, TemplateFormat, TemplateGetParams, TemplateHeader, TemplateHeaderExample, TemplateLimitedTimeOffer, TemplateOptimizationSpec, type TemplateOptions, type TemplateParameter, TemplateRequestBody, TemplateResponse, TemplateStatus, TemplateStatusEnum, TemplateStatusType, type TerminateCallRequest, type TextMessage, type TextMessageHandler, type TextMessageParams, type TextObject, type TextParameter, type TextProcessedMessage, ThreadControlApi, ThreadControlBaseParams, ThreadControlClass, ThreadControlResponse, ThreadControlRole, ThreadControlUserIdentifier, Throughput, ThroughputLevel, ThroughputResponse, TwoStepVerificationApi, type TwoStepVerificationClass, TwoStepVerificationParams, type TwoStepVerificationRequest, URLButton, UnblockUsersRequest, UnifiedCertStatus, type UnsupportedMessage, UpdateBusinessComplianceInfoRequest, type UpdateBusinessProfileRequest, type UpdateCallingSettingsRequest, type UpdateCommerceSettingsRequest, type UpdateFlowResponse, type UpdateGroupSettingsRequest, UpdateOfficialBusinessAccountStatusRequest, UpdatePhoneNumberSettingsRequest, UpdatePhoneNumberStatusRequest, type UpdateQrCodeRequest, UpdateUsernameRequest, UpdateWabaAccountRequest, UpdateWabaSubscription, UpdateWhatsAppBusinessProfileRequest, type UploadBusinessProfileResponse, type UploadHandle, UploadMediaInput, UploadMediaOptions, type UploadMediaParams, UploadMediaResponse, type UploadSession, type UploadSessionResponse, type UserAction, type UserActionHandler, type UserActionType, type UserActionsWebhookValue, UsernameResponse, UsernameStatus, UsernameSuggestionsResponse, UsernameTransferAction, type ValidateFlowJsonResponse, VerifyCodeRequest, VerifyPreVerifiedPhoneNumberCodeRequest, type VideoMediaObject, VideoMediaTypes, VideoMediaTypesEnum, VideoMediaTypesType, type VideoMessage, type VideoMessageHandler, type VideoProcessedMessage, WABAClass, WHATSAPP_ERROR_CODES, WabaAccount, WabaAccountFields, WabaAccountFieldsParam, WabaAccountReviewStatus, WabaAccountStatus, WabaApi, WabaBusinessVerificationStatus, WabaConfigEnum, type WabaConfigType, WabaFieldsParam, WabaGraphObject, WabaHealthStatus, WabaHealthStatusCanSendMessage, WabaHealthStatusEntity, WabaHealthStatusError, WabaListParams, WabaListResponse, WabaSubscription, WabaSubscriptions, type WebhookContact, type WebhookDedupeConfig, type WebhookDedupeOptions, type WebhookEvent, type WebhookFieldHandler, type WebhookFieldHandlerMap, type WebhookFieldHandlerOptions, type WebhookFieldType, type WebhookFieldValue, type WebhookFieldValueMap, type WebhookHandlerContext, type WebhookMessage, type WebhookPayload, WebhookProcessor, type WebhookResponse, type WebhookSignatureOptions, WebhookTypes, WebhookTypesEnum, WebhookTypesType, type WebhookValue, type WeeklyOperatingHours, WhatsApp, WhatsApp as default, WhatsAppApiError, WhatsAppAuthorizationError, WhatsAppBlockUserError, WhatsAppCallingError, type WhatsAppConfig, WhatsAppError, type WhatsAppErrorCode, WhatsAppFlowError, WhatsAppGroupError, WhatsAppIntegrityError, type WhatsAppMessage, WhatsAppNetworkError, WhatsAppSendMessageError, WhatsAppThrottlingError, WhatsAppUnknownError, WhatsAppValidationError, type WindowTimestamp, buildFieldsQueryString, canSendFreeformMessage, constructFullUrl, createAuthenticationTemplate, createCatalogTemplate, createCouponTemplate, createLimitedTimeOfferTemplate, createMPMTemplate, createMediaCardCarouselTemplate, createOTPTemplate, createProductCardCarouselTemplate, createSPMTemplate, createTemplate, createWhatsAppApiError, decryptFlowRequest, decryptFlowRequestAsync, encryptFlowResponse, encryptFlowResponseAsync, expressWebhookHandler, extractMessageText, fastifyWebhookHandler, formatConfigTable, generateEncryption, generateXHub256Sig, generateXHub256SigAsync, getContactsInfo, getCustomerServiceWindow, getFreeEntryPointWindow, getInteractiveReply, getLocationInfo, getMediaInfo, getOrderInfo, getReactionInfo, honoWebhookHandler, isApiPermissionErrorCode, isAudioMessage, isAuthorizationErrorCode, isBlockUserErrorCode, isButtonMessage, isButtonReply, isCallingErrorCode, isContactsMessage, isDocumentMessage, isFlowDataExchangeRequest, isFlowErrorCode, isFlowErrorRequest, isFlowPingRequest, isGroupErrorCode, isImageMessage, isIntegrityErrorCode, isInteractiveMessage, isListReply, isLocationMessage, isMetaError, isNfmReply, isOrderMessage, isReactionMessage, isSendMessageErrorCode, isStickerMessage, isSystemMessage, isTextMessage, isThrottlingErrorCode, isValidWebhookSignature, isVideoMessage, isWhatsAppApiErrorResponse, isWhatsAppAuthorizationError, isWhatsAppBlockUserError, isWhatsAppCallingError, isWhatsAppErrorCode, isWhatsAppFlowError, isWhatsAppGroupError, isWhatsAppIntegrityError, isWhatsAppSendMessageError, isWhatsAppThrottlingError, nextjsAppWebhookHandler, nextjsPagesWebhookHandler, normalizeMetaError, objectToQueryString, parseRateLimitHeaders, parseRetryAfter, processFlowRequest, processWebhookMessages, verifyWebhookSignature };
 //# sourceMappingURL=index.d.mts.map