meta-cloud-api 0.2.33 → 0.2.35

package/dist/index.d.ts

@@ -1,533 +1,44 @@
-import { M as MessageTypesEnum, H as HttpMethodsEnum, S as SDKEnums } from './enums-Z1f7QuVx.js';
-export { a as StatusEnum, W as WebhookTypesEnum } from './enums-Z1f7QuVx.js';
-import { WhatsAppConfig, WabaConfigType } from './shared/types/config.js';
-import { IncomingMessage } from 'http';
-import { F as FlowApi, a as FlowEndpointRequest, b as FlowDataExchangeRequest, c as FlowActionEnum, d as FlowErrorNotificationRequest, e as FlowHealthCheckRequest, f as FlowType } from './FlowApi-C5-2BGAw.js';
-export { g as Flow, h as FlowClass, i as FlowEndpointResponse, j as FlowTypeEnum } from './FlowApi-C5-2BGAw.js';
-import { E as EncryptionApi } from './EncryptionApi-CwxQlC-2.js';
-import { M as MediaApi } from './MediaApi-VqxndaBJ.js';
-export { a as MediaClass, b as MediaResponse, c as MediasResponse, U as UploadMediaResponse } from './MediaApi-VqxndaBJ.js';
-import { M as MessagesApi } from './MessageApi-CHc6bn3g.js';
-export { A as AudioMediaObject, C as ContactObject, D as DocumentMediaObject, I as ImageMediaObject, a as InteractiveObject, L as LocationObject, b as MessageRequestParams, d as MessageTemplateObject, c as MessagesResponse, R as ReactionParams, S as StatusParams, e as StickerMediaObject, T as TextMessageParams, f as TextObject, V as VideoMediaObject } from './MessageApi-CHc6bn3g.js';
-import { P as PhoneNumberApi } from './PhoneNumberApi-C-bs6YAe.js';
-export { a as PhoneNumberClass, b as PhoneNumberResponse } from './PhoneNumberApi-C-bs6YAe.js';
-import { B as BusinessProfileApi } from './BusinessProfileApi-DDkv2WQK.js';
-export { a as BusinessProfileClass, b as BusinessProfileResponse } from './BusinessProfileApi-DDkv2WQK.js';
-import { Q as QrCodeApi } from './QrCodeApi-BjlyPUXV.js';
-export { a as QrCodeClass, b as QrCodeResponse } from './QrCodeApi-BjlyPUXV.js';
-import { R as RegistrationApi } from './RegistrationApi-D7Bg8BUz.js';
-export { a as RegistrationClass } from './RegistrationApi-D7Bg8BUz.js';
-import { T as TemplateApi } from './TemplateApi-dmZbvMkO.js';
-export { a as TemplateClass, b as TemplateResponse } from './TemplateApi-dmZbvMkO.js';
-import { T as TwoStepVerificationApi } from './TwoStepVerificationApi-DaYWPjY_.js';
-import { W as WabaApi } from './WabaApi-CMoTCWiH.js';
-export { b as WABAClass, a as WabaAccount } from './WabaApi-CMoTCWiH.js';
-import { Agent } from 'https';
-import { R as RequesterClass } from './base-BG2gtoDs.js';
+export { W as WebhookContact, a as WebhookEvent, c as WebhookHandler, b as WebhookMessage } from './WebhookHandler-Dn1NlyGm.js';
+import { g as FlowEndpointRequest, o as FlowDataExchangeRequest, c as FlowActionEnum, p as FlowErrorNotificationRequest, q as FlowHealthCheckRequest } from './FlowApi-QDjrvCLp.js';
+export { a as Flow, F as FlowApi, f as FlowClass, h as FlowEndpointResponse, b as FlowType, n as FlowTypeEnum } from './FlowApi-QDjrvCLp.js';
+export { WabaConfigType, WhatsAppConfig } from './shared/types/config.js';
+export { A as AudioMediaTypesEnum, B as BusinessVerticalEnum, a as ButtonPositionEnum, b as ButtonTypesEnum, C as CategoryEnum, c as ComponentTypesEnum, d as ConversationTypesEnum, e as CurrencyCodesEnum, D as DataLocalizationRegionEnum, f as DocumentMediaTypesEnum, H as HttpMethodsEnum, I as ImageMediaTypesEnum, g as InteractiveTypesEnum, L as LanguagesEnum, M as MessageTypesEnum, P as ParametersTypesEnum, R as ReferralSourceTypesEnum, h as RequestCodeMethodsEnum, S as StatusEnum, i as StickerMediaTypesEnum, j as SystemChangeTypesEnum, T as TemplateStatusEnum, V as VideoMediaTypesEnum, W as WabaConfigEnum, k as WebhookTypesEnum } from './enums-DcRC4vFO.js';
+export { E as EncryptionApi } from './EncryptionApi-1aZ13Qyh.js';
+export { a as MediaClass, b as MediaResponse, c as MediasResponse, U as UploadMediaResponse } from './MediaApi-V44kQnsN.js';
+export { A as AudioMediaObject, C as ContactObject, D as DocumentMediaObject, I as ImageMediaObject, a as InteractiveObject, L as LocationObject, b as MessageRequestParams, d as MessageTemplateObject, M as MessagesApi, c as MessagesResponse, R as ReactionParams, S as StatusParams, e as StickerMediaObject, T as TextMessageParams, f as TextObject, V as VideoMediaObject } from './MessageApi-BhSK0pfd.js';
+export { P as PhoneNumberApi, c as PhoneNumberClass, d as PhoneNumberResponse } from './PhoneNumberApi-CPAIS17R.js';
+export { B as BusinessProfileApi, a as BusinessProfileClass, e as BusinessProfileResponse } from './BusinessProfileApi-BJ9zy6c2.js';
+export { Q as QrCodeApi, a as QrCodeClass, b as QrCodeResponse } from './QrCodeApi-BjPYQIWF.js';
+export { R as RegistrationApi, a as RegistrationClass } from './RegistrationApi-CGlvAgaz.js';
+export { T as TemplateApi, a as TemplateClass, e as TemplateResponse } from './TemplateApi-D_23Ys02.js';
+export { T as TwoStepVerificationApi } from './TwoStepVerificationApi-CXMjxkUl.js';
+export { b as WABAClass, a as WabaAccount, W as WabaApi } from './WabaApi-BwnBkMPm.js';
+export { WhatsApp } from './core/whatsapp/index.js';
 export { MetaError, isMetaError } from './shared/utils/isMetaError.js';
+import './base-DtfdeScM.js';
+import 'https';
 
-/**
- * Represents a message received through the webhook
- * Based on Meta's documentation: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components#messages-object
- */
-interface WebhookMessage {
-    /**
-     * The message ID
-     */
-    id: string;
-    /**
-     * The sender's phone number
-     */
-    from: string;
-    /**
-     * The timestamp of the message
-     */
-    timestamp: string;
-    /**
-     * The type of message (text, image, etc.)
-     */
-    type: MessageTypesEnum;
-    /**
-     * The phone number ID that received the message
-     */
-    phoneNumberId: string;
-    /**
-     * The display phone number that received the message
-     */
-    displayPhoneNumber: string;
-    /**
-     * The profile name of the sender
-     */
-    profileName: string;
-    /**
-     * Text object for text messages
-     */
-    text?: {
-        /**
-         * The text content of the message
-         */
-        body: string;
-    };
-    /**
-     * Image object for image messages
-     */
-    image?: {
-        /**
-         * The image caption (if provided)
-         */
-        caption?: string;
-        /**
-         * The SHA256 hash of the image
-         */
-        sha256?: string;
-        /**
-         * The ID for the image
-         */
-        id: string;
-        /**
-         * The MIME type of the image
-         */
-        mime_type: string;
-    };
-    /**
-     * Video object for video messages
-     */
-    video?: {
-        /**
-         * The video caption (if provided)
-         */
-        caption?: string;
-        /**
-         * The SHA256 hash of the video
-         */
-        sha256?: string;
-        /**
-         * The ID for the video
-         */
-        id: string;
-        /**
-         * The MIME type of the video
-         */
-        mime_type: string;
-    };
-    /**
-     * Audio object for audio messages
-     */
-    audio?: {
-        /**
-         * The ID for the audio file
-         */
-        id: string;
-        /**
-         * The MIME type of the audio file
-         */
-        mime_type: string;
-        /**
-         * Whether the audio is a voice message
-         */
-        voice?: boolean;
-    };
-    /**
-     * Document object for document messages
-     */
-    document?: {
-        /**
-         * The document caption (if provided)
-         */
-        caption?: string;
-        /**
-         * The document filename
-         */
-        filename: string;
-        /**
-         * The SHA256 hash of the document
-         */
-        sha256?: string;
-        /**
-         * The ID for the document
-         */
-        id: string;
-        /**
-         * The MIME type of the document
-         */
-        mime_type: string;
-    };
-    /**
-     * Sticker object for sticker messages
-     */
-    sticker?: {
-        /**
-         * The ID for the sticker
-         */
-        id: string;
-        /**
-         * Whether this is an animated sticker
-         */
-        animated: boolean;
-        /**
-         * The MIME type of the sticker
-         */
-        mime_type: string;
-    };
-    /**
-     * Reaction object for reaction messages
-     */
-    reaction?: {
-        /**
-         * The ID of the message being reacted to
-         */
-        message_id: string;
-        /**
-         * Emoji used for the reaction
-         */
-        emoji: string;
-    };
-    /**
-     * Contacts object for contact messages
-     */
-    contacts?: Array<{
-        /**
-         * The contact's name
-         */
-        name: {
-            /**
-             * The formatted name
-             */
-            formatted_name: string;
-            /**
-             * The first name
-             */
-            first_name?: string;
-            /**
-             * The last name
-             */
-            last_name?: string;
-            /**
-             * The middle name
-             */
-            middle_name?: string;
-            /**
-             * The suffix
-             */
-            suffix?: string;
-            /**
-             * The prefix
-             */
-            prefix?: string;
-        };
-        /**
-         * The contact's phone numbers
-         */
-        phones?: Array<{
-            phone: string;
-            type?: string;
-            wa_id?: string;
-        }>;
-        /**
-         * The contact's emails
-         */
-        emails?: Array<{
-            email: string;
-            type?: string;
-        }>;
-        /**
-         * The contact's addresses
-         */
-        addresses?: Array<{
-            street?: string;
-            city?: string;
-            state?: string;
-            zip?: string;
-            country?: string;
-            country_code?: string;
-            type?: string;
-        }>;
-        /**
-         * The contact's organizations
-         */
-        org?: {
-            company?: string;
-            department?: string;
-            title?: string;
-        };
-        /**
-         * The contact's URLs
-         */
-        urls?: Array<{
-            url: string;
-            type?: string;
-        }>;
-        /**
-         * The contact's birthday (YYYY-MM-DD format)
-         */
-        birthday?: string;
-    }>;
-    /**
-     * Location object for location messages
-     */
-    location?: {
-        /**
-         * Latitude of the location
-         */
-        latitude: number;
-        /**
-         * Longitude of the location
-         */
-        longitude: number;
-        /**
-         * Name of the location
-         */
-        name?: string;
-        /**
-         * Address of the location
-         */
-        address?: string;
-    };
-    /**
-     * Interactive object for interactive messages
-     */
-    interactive?: {
-        /**
-         * Type of the interactive message
-         * Can be: button_reply, list_reply, flow, nfm_reply, etc.
-         */
-        type: string;
-        /**
-         * ID for the button that was clicked
-         */
-        button_reply?: {
-            id: string;
-            title: string;
-        };
-        /**
-         * ID for the list item that was selected
-         */
-        list_reply?: {
-            id: string;
-            title: string;
-            description?: string;
-        };
-        /**
-         * NFM (No-Code Flow Message) reply data
-         */
-        nfm_reply?: {
-            /**
-             * Response data in JSON format
-             */
-            response_json: string;
-            /**
-             * Body text of the reply
-             */
-            body: string;
-            /**
-             * Name of the flow
-             */
-            name: string;
-        };
-    };
-    /**
-     * System object for system messages (like user phone number changes)
-     */
-    system?: {
-        /**
-         * The type of system update
-         */
-        type: string;
-        /**
-         * User's identity if the update is a customer identity change
-         */
-        identity?: string;
-        /**
-         * Old and new phone numbers if the update is a phone number change
-         */
-        customer?: {
-            /**
-             * The previous phone number
-             */
-            previous_wa_id: string;
-            /**
-             * The new phone number
-             */
-            wa_id: string;
-        };
-    };
-    /**
-     * Order object for order messages
-     */
-    order?: {
-        /**
-         * Catalog ID
-         */
-        catalog_id: string;
-        /**
-         * Product items in the order
-         */
-        product_items: Array<{
-            /**
-             * Product ID
-             */
-            product_retailer_id: string;
-            /**
-             * Quantity of the product
-             */
-            quantity: number;
-            /**
-             * Item price
-             */
-            item_price: number;
-            /**
-             * Currency code
-             */
-            currency: string;
-        }>;
-        /**
-         * Text message included with the order
-         */
-        text?: string;
-    };
-    /**
-     * Context object, included when a user replies or interacts
-     */
-    context?: {
-        /**
-         * ID of the message
-         */
-        id?: string;
-        /**
-         * ID of the sender
-         */
-        from?: string;
-        /**
-         * ID of the message being replied to or interacted with
-         */
-        message_id: string;
-        /**
-         * ID of the forwarded message, if applicable
-         */
-        forwarded?: boolean;
-        /**
-         * Frequently forwarded status
-         */
-        frequently_forwarded?: boolean;
-        /**
-         * Original message information if the message was referred
-         */
-        referred_product?: {
-            /**
-             * Catalog ID
-             */
-            catalog_id: string;
-            /**
-             * Product ID
-             */
-            product_retailer_id: string;
-        };
-    };
-    /**
-     * Errors array, if the message had errors
-     */
-    errors?: Array<{
-        /**
-         * Error code
-         */
-        code: number;
-        /**
-         * Error title
-         */
-        title: string;
-        /**
-         * Error message
-         */
-        message: string;
-        /**
-         * Error details object
-         */
-        error_data?: {
-            /**
-             * Describes the error details
-             */
-            details: string;
-        };
-    }>;
-    /**
-     * Button object for button messages
-     */
-    button?: {
-        /**
-         * The payload for the button
-         */
-        payload: string;
-        /**
-         * Button text
-         */
-        text: string;
-    };
-    /**
-     * The original message data as received from the webhook
-     */
-    originalData: any;
-}
-/**
- * Webhook event received from WhatsApp
- */
-interface WebhookEvent {
-    /**
-     * The field type of the event
-     */
-    field: string;
-    /**
-     * The event data
-     */
-    value: any;
-    /**
-     * The timestamp when the event was received
-     */
-    timestamp: number;
-}
-
-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>;
+interface LoggerInterface {
+    log(...data: any[]): void;
+    error(...data: any[]): void;
+    warn(...data: any[]): void;
+    info(...data: any[]): void;
+    debug(...data: any[]): void;
 }
 
-declare class WhatsAppClass {
-    constructor(config?: WhatsAppConfig);
-    readonly messages: MessagesApi;
-    readonly templates: TemplateApi;
-    readonly phoneNumber: PhoneNumberApi;
-    readonly qrCode: QrCodeApi;
-    readonly encryption: EncryptionApi;
-    readonly twoStepVerification: TwoStepVerificationApi;
-    readonly registration: RegistrationApi;
-    readonly media: MediaApi;
-    readonly waba: WabaApi;
-    readonly flow: FlowApi;
-    readonly businessProfile: BusinessProfileApi;
-    updateTimeout(ms: number): boolean;
-    updatePhoneNumberId(phoneNumberId: number): boolean;
-    updateAccessToken(accessToken: string): boolean;
-    updateWabaId(wabaId: string): boolean;
-}
+declare function buildFieldsQueryString(fields?: string[] | string): string;
 
-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>;
+declare class Logger implements LoggerInterface {
+    private name;
+    private debug;
+    constructor(name: string, debug?: boolean);
+    log(...data: any[]): void;
+    error(...data: any[]): void;
+    warn(...data: any[]): void;
+    info(...data: any[]): void;
 }
 
-declare const importConfig: (inputConfig?: WhatsAppConfig) => WabaConfigType;
+declare const objectToQueryString: (params: Record<string, any>) => string;
 
 declare const DATA_EXCHANGE_ACTIONS: readonly [FlowActionEnum.DATA_EXCHANGE, FlowActionEnum.INIT, FlowActionEnum.BACK];
 declare const ERROR_ACTIONS: readonly [FlowActionEnum.DATA_EXCHANGE, FlowActionEnum.INIT];
@@ -569,151 +80,4 @@ declare function isFlowErrorRequest(request: FlowEndpointRequest): request is Fl
  */
 declare function isFlowPingRequest(request: FlowEndpointRequest): request is FlowHealthCheckRequest;
 
-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>;
-}
-
-declare class WhatsApp implements WhatsAppClass {
-    config: WabaConfigType;
-    requester: Readonly<Requester>;
-    readonly messages: MessagesApi;
-    readonly templates: TemplateApi;
-    readonly phoneNumber: PhoneNumberApi;
-    readonly qrCode: QrCodeApi;
-    readonly encryption: EncryptionApi;
-    readonly twoStepVerification: TwoStepVerificationApi;
-    readonly registration: RegistrationApi;
-    readonly media: MediaApi;
-    readonly waba: WabaApi;
-    readonly flow: FlowApi;
-    readonly businessProfile: BusinessProfileApi;
-    static readonly Enums: typeof SDKEnums;
-    constructor(config?: WhatsAppConfig);
-    private userAgent;
-    updateTimeout(ms: number): boolean;
-    updatePhoneNumberId(phoneNumberId: number): boolean;
-    updateAccessToken(accessToken: string): boolean;
-    updateWabaId(wabaId: string): boolean;
-}
-
-interface IRequest extends IncomingMessage {
-    body: any;
-    query: Record<string, any>;
-    method?: string;
-}
-interface IResponse {
-    status: (code: number) => IResponse;
-    send: (body: any) => IResponse | void;
-    json: (body: any) => IResponse | void;
-    end: () => void;
-}
-/**
- * Webhook handler for WhatsApp Cloud API
- */
-declare class WebhookHandler {
-    private config;
-    private client;
-    private messageHandlers;
-    private eventHandlers;
-    private preProcessHandler;
-    private postProcessHandler;
-    private flowHandlers;
-    /**
-     * Create a new WebhookHandler
-     * @param config The WhatsApp configuration
-     */
-    constructor(config: WhatsAppConfig);
-    /**
-     * Handle a GET request for webhook verification
-     */
-    handleVerificationRequest<Req extends IRequest, Res extends IResponse>(req: Req, res: Res): void;
-    handleVerificationRequest<Req extends IRequest>(req: Req): string;
-    /**
-     * Handle a POST request for webhook events
-     */
-    handleWebhookRequest<Req extends IRequest, Res extends IResponse>(req: Req, res: Res): Promise<void>;
-    handleWebhookRequest<Req extends IRequest>(req: Req): Promise<{
-        success: boolean;
-        errors?: string[];
-    }>;
-    /**
-     * Handle webhook requests (both verification and events)
-     */
-    handleRequest<Req extends IRequest, Res extends IResponse>(req: Req, res: Res): void | Promise<void>;
-    handleRequest<Req extends IRequest>(req: Req): string | Promise<{
-        success: boolean;
-        errors?: string[];
-    }>;
-    /**
-     * Process incoming messages
-     */
-    private processMessages;
-    /**
-     * Process other webhook events
-     */
-    private processEvent;
-    /**
-     * Register a message handler for a specific message type
-     */
-    onMessage(type: MessageTypesEnum, handler: (whatsapp: WhatsApp, message: WebhookMessage) => void | Promise<void>): void;
-    /**
-     * Register an event handler for a specific field
-     */
-    onEvent(field: string, handler: (event: WebhookEvent) => void | Promise<void>): void;
-    /**
-     * Register a pre-process handler that runs before all message handlers
-     */
-    onMessagePreProcess(handler: (whatsapp: WhatsApp, message: WebhookMessage) => void | Promise<void>): void;
-    /**
-     * Register a post-process handler that runs after all message handlers
-     */
-    onMessagePostProcess(handler: (whatsapp: WhatsApp, message: WebhookMessage) => void | Promise<void>): void;
-    handleFlowRequest<Req extends IRequest & {
-        rawBody: string;
-    }, Res extends IResponse>(req: Req, res: Res): Promise<void>;
-    handleFlowRequest<Req extends IRequest & {
-        rawBody: string;
-    }>(req: Req): Promise<{
-        statusCode: number;
-        body: any;
-        headers?: Record<string, string>;
-    }>;
-    /**
-     * Validate the request signature
-     */
-    isRequestSignatureValid(req: IRequest & {
-        rawBody: string;
-    }): boolean;
-    /**
-     * Decrypt a flow request
-     */
-    decryptRequest(body: any): {
-        decryptedBody: FlowEndpointRequest;
-        aesKeyBuffer: Buffer;
-        initialVectorBuffer: Buffer;
-    };
-    /**
-     * Encrypt a flow response
-     */
-    private encryptResponse;
-    /**
-     * Register a flow handler for a specific flow type
-     */
-    onFlow(type: FlowType, handler: (whatsapp: WhatsApp, request: FlowEndpointRequest) => any | Promise<any>): void;
-}
-
-export { BusinessProfileApi, EncryptionApi, FlowApi, FlowEndpointRequest, FlowType, HttpMethodsEnum, type IRequest, type IResponse, MessageTypesEnum, MessagesApi, PhoneNumberApi, QrCodeApi, RegistrationApi, TemplateApi, TwoStepVerificationApi, WabaApi, WabaConfigType, WebhookHandler, importConfig, isFlowDataExchangeRequest, isFlowErrorRequest, isFlowPingRequest };
+export { FlowEndpointRequest, Logger, buildFieldsQueryString, isFlowDataExchangeRequest, isFlowErrorRequest, isFlowPingRequest, objectToQueryString };