meta-cloud-api 1.0.0 → 1.0.1

package/dist/BusinessProfileApi-WXscSgo-.d.ts

@@ -0,0 +1,353 @@
+import { a as BaseClass, B as BaseAPI } from './base-CdGDdVEl.js';
+import { WabaConfigType } from './types/config.js';
+import { e as ResponseSuccess, R as RequesterClass } from './request-vYMaEfk5.js';
+import { k as BusinessVerticalEnum } from './enums-BZd9T2ul.js';
+
+/**
+ * Upload session information for creating upload sessions.
+ */
+interface UploadSession {
+    id: string;
+    video?: boolean;
+}
+/**
+ * Response from creating an upload session.
+ */
+interface UploadSessionResponse {
+    id: string;
+}
+/**
+ * Response from uploading business profile media.
+ */
+interface UploadBusinessProfileResponse {
+    h: string;
+}
+/**
+ * Upload handle information containing file details and handle.
+ */
+interface UploadHandle {
+    handle: string;
+    file_size: number;
+    upload_result: {
+        handle_type: string;
+        name: string;
+    };
+}
+/**
+ * Request parameters for creating upload session.
+ */
+interface CreateUploadSessionParams {
+    /**
+     * Length of the file to be uploaded in bytes.
+     */
+    fileLength: number;
+    /**
+     * MIME type of the file (e.g., 'image/jpeg').
+     */
+    fileType: string;
+    /**
+     * Name of the file with extension.
+     */
+    fileName: string;
+}
+/**
+ * Request parameters for uploading media.
+ */
+interface UploadMediaParams {
+    /**
+     * The upload session ID from createUploadSession response.
+     */
+    uploadId: string;
+    /**
+     * The binary data of the file (Buffer).
+     */
+    file: Buffer;
+}
+/**
+ * Request parameters for getting upload handle.
+ */
+interface GetUploadHandleParams {
+    /**
+     * The upload session ID from createUploadSession response.
+     */
+    uploadId: string;
+}
+
+/**
+ * Available fields that can be requested when retrieving a business profile.
+ */
+type BusinessProfileField = 'about' | 'address' | 'description' | 'email' | 'profile_picture_url' | 'websites' | 'vertical';
+type BusinessProfileFieldsParam = BusinessProfileField[] | string;
+/**
+ * Business profile data structure containing all profile information.
+ */
+interface BusinessProfileData {
+    /**
+     * The business's About text. This text appears in the business's profile, beneath its profile image,
+     * phone number, and contact buttons.
+     * - String cannot be empty
+     * - Strings must be between 1 and 139 characters
+     * - Rendered emojis are supported however their unicode values are not.
+     *   Emoji unicode values must be Java- or JavaScript-escape encoded
+     * - Hyperlinks can be included but will not render as clickable links
+     * - Markdown is not supported
+     */
+    about?: string;
+    /**
+     * Address of the business. Character limit 256.
+     */
+    address?: string;
+    /**
+     * Description of the business. Character limit 512.
+     */
+    description?: string;
+    /**
+     * The contact email address (in valid email format) of the business. Character limit 128.
+     */
+    email?: string;
+    /**
+     * The messaging service used for the request. Always set it to "whatsapp" if you are using
+     * the WhatsApp Business API.
+     */
+    messaging_product: string;
+    /**
+     * Profile picture URL.
+     */
+    profile_picture_url?: string;
+    /**
+     * The URLs associated with the business. For instance, a website, Facebook Page, or Instagram.
+     * - You must include the http:// or https:// portion of the URL
+     * - There is a maximum of 2 websites with a maximum of 256 characters each
+     */
+    websites?: string[];
+    /**
+     * Business category. This can be either an empty string or one of the predefined business categories.
+     * @see BusinessVerticalEnum for all available options
+     */
+    vertical?: BusinessVerticalEnum | string;
+}
+/**
+ * Response structure for business profile GET requests.
+ */
+interface BusinessProfileResponse {
+    data: BusinessProfileData[];
+}
+/**
+ * Request structure for updating business profile.
+ */
+interface UpdateBusinessProfileRequest {
+    /**
+     * The messaging service used for the request. Always set it to "whatsapp" if you are using
+     * the WhatsApp Business API.
+     * @required
+     */
+    messaging_product: string;
+    /**
+     * The business's About text. This text appears in the business's profile, beneath its profile image,
+     * phone number, and contact buttons.
+     * - String cannot be empty
+     * - Strings must be between 1 and 139 characters
+     * - Rendered emojis are supported however their unicode values are not.
+     *   Emoji unicode values must be Java- or JavaScript-escape encoded
+     * - Hyperlinks can be included but will not render as clickable links
+     * - Markdown is not supported
+     */
+    about?: string;
+    /**
+     * Address of the business. Character limit 256.
+     */
+    address?: string;
+    /**
+     * Description of the business. Character limit 512.
+     */
+    description?: string;
+    /**
+     * Business category. This can be either an empty string or one of the predefined business categories.
+     * @see BusinessVerticalEnum for all available options
+     */
+    vertical?: BusinessVerticalEnum | string;
+    /**
+     * The contact email address (in valid email format) of the business. Character limit 128.
+     */
+    email?: string;
+    /**
+     * The URLs associated with the business. For instance, a website, Facebook Page, or Instagram.
+     * - You must include the http:// or https:// portion of the URL
+     * - There is a maximum of 2 websites with a maximum of 256 characters each
+     */
+    websites?: string[];
+    /**
+     * Handle of the profile picture. This handle is generated when you upload the binary file
+     * for the profile picture to Meta using the Resumable Upload API.
+     */
+    profile_picture_handle?: string;
+}
+declare class BusinessProfileClass extends BaseClass {
+    /**
+     * Get your business profile.
+     * @param fields Specific fields to be returned in the response. If not specified, all fields will be returned.
+     */
+    getBusinessProfile(fields?: BusinessProfileFieldsParam): Promise<BusinessProfileResponse>;
+    /**
+     * Update your business profile.
+     * @param updateRequest The request object containing the fields to update.
+     */
+    updateBusinessProfile(updateRequest: UpdateBusinessProfileRequest): Promise<ResponseSuccess>;
+    /**
+     * Create an upload session for profile picture.
+     * @param fileLength Length of the file to be uploaded in bytes.
+     * @param fileType MIME type of the file (e.g., 'image/jpeg').
+     * @param fileName Name of the file.
+     */
+    createUploadSession(fileLength: number, fileType: string, fileName: string): Promise<UploadSessionResponse>;
+    /**
+     * Upload media file to the upload session.
+     * @param uploadId The ID of the upload session.
+     * @param file The binary data of the file.
+     */
+    uploadMedia(uploadId: string, file: Buffer): Promise<UploadBusinessProfileResponse>;
+    /**
+     * Get the upload handle information.
+     * @param uploadId The ID of the upload session.
+     */
+    getUploadHandle(uploadId: string): Promise<UploadHandle>;
+}
+
+/**
+ * API for managing WhatsApp Business Profiles and profile pictures.
+ *
+ * This API allows you to:
+ * - Get business profile information
+ * - Update business profile details
+ * - Upload profile pictures using a three-step process:
+ *   1. Create an upload session
+ *   2. Upload the image binary data
+ *   3. Get the upload handle to use when updating the profile
+ */
+declare class BusinessProfileApi extends BaseAPI implements BusinessProfileClass {
+    private readonly endpoint;
+    constructor(config: WabaConfigType, client: RequesterClass);
+    /**
+     * Get your business profile information.
+     *
+     * Use this method to retrieve details about your WhatsApp business profile, including
+     * about text, address, description, email, profile picture URL, websites, and vertical.
+     *
+     * @param fields Fields to be returned in the response. If not specified, all fields will be returned.
+     *               Possible values: about, address, description, email, profile_picture_url, websites, vertical
+     * @returns The business profile information.
+     *
+     * @example
+     * // Get all business profile fields
+     * const profile = await whatsappClient.businessProfile.getBusinessProfile();
+     *
+     * // Get specific business profile fields
+     * const profile = await whatsappClient.businessProfile.getBusinessProfile('about,address,email');
+     *
+     * // Using the BusinessProfileFieldsParam type
+     * const profile = await whatsappClient.businessProfile.getBusinessProfile(['about', 'address', 'email']);
+     */
+    getBusinessProfile(fields?: BusinessProfileFieldsParam): Promise<BusinessProfileResponse>;
+    /**
+     * Update your business profile.
+     *
+     * Use this method to update one or more fields of your WhatsApp business profile.
+     *
+     * @param updateRequest The request object containing the fields to update.
+     *        - messaging_product: Required. Always set to "whatsapp".
+     *        - about: Optional. Business's About text (1-139 characters).
+     *        - address: Optional. Business address (max 256 characters).
+     *        - description: Optional. Business description (max 512 characters).
+     *        - vertical: Optional. Business category (use BusinessVerticalEnum for type safety).
+     *        - email: Optional. Contact email (valid format, max 128 characters).
+     *        - websites: Optional. Up to 2 URLs (max 256 characters each).
+     *        - profile_picture_handle: Optional. Handle from upload process.
+     * @returns Response indicating success or failure.
+     *
+     * @example
+     * // Update business profile with multiple fields including vertical using enum
+     * await whatsappClient.businessProfile.updateBusinessProfile({
+     *   messaging_product: 'whatsapp',
+     *   about: 'We provide excellent service',
+     *   email: 'contact@example.com',
+     *   websites: ['https://example.com'],
+     *   vertical: BusinessVerticalEnum.RETAIL
+     * });
+     */
+    updateBusinessProfile(updateRequest: UpdateBusinessProfileRequest): Promise<ResponseSuccess>;
+    /**
+     * Create an upload session for a profile picture.
+     *
+     * This is the first step in the profile picture upload process.
+     *
+     * @param fileLength Length of the file to be uploaded in bytes.
+     * @param fileType MIME type of the file (e.g., 'image/jpeg').
+     * @param fileName Name of the file with extension.
+     * @returns Response containing the upload session ID needed for the next step.
+     *
+     * @example
+     * // Create upload session for profile picture
+     * const session = await whatsappClient.businessProfile.createUploadSession(
+     *   fileBuffer.length,
+     *   'image/jpeg',
+     *   'profile.jpg'
+     * );
+     * const uploadSessionId = session.upload_session_id;
+     */
+    createUploadSession(fileLength: number, fileType: string, fileName: string): Promise<UploadSessionResponse>;
+    /**
+     * Upload media file to the upload session.
+     *
+     * This is the second step in the profile picture upload process.
+     * Upload the binary content of the file to the previously created upload session.
+     *
+     * @param uploadId The upload session ID from createUploadSession response.
+     * @param file The binary data of the file (Buffer).
+     * @returns Response indicating success or failure.
+     *
+     * @example
+     * // Upload the actual file content
+     * await whatsappClient.businessProfile.uploadMedia(
+     *   uploadSessionId,
+     *   fileBuffer
+     * );
+     */
+    uploadMedia(uploadId: string, file: Buffer): Promise<UploadBusinessProfileResponse>;
+    /**
+     * Get the upload handle information.
+     *
+     * This is the third step in the profile picture upload process.
+     * After uploading the file, get the handle to use when updating the profile.
+     *
+     * @param uploadId The upload session ID from createUploadSession response.
+     * @returns Response containing the upload handle information.
+     *
+     * @example
+     * // Complete profile picture update process
+     * // 1. Create upload session
+     * const session = await whatsappClient.businessProfile.createUploadSession(
+     *   fileBuffer.length, 'image/jpeg', 'profile.jpg'
+     * );
+     *
+     * // 2. Upload the image data
+     * await whatsappClient.businessProfile.uploadMedia(
+     *   session.upload_session_id, fileBuffer
+     * );
+     *
+     * // 3. Get the handle for the uploaded file
+     * const handleInfo = await whatsappClient.businessProfile.getUploadHandle(
+     *   session.upload_session_id
+     * );
+     *
+     * // 4. Update profile with new picture and business information
+     * await whatsappClient.businessProfile.updateBusinessProfile({
+     *   messaging_product: 'whatsapp',
+     *   profile_picture_handle: handleInfo.handle,
+     *   vertical: BusinessVerticalEnum.RESTAURANT,
+     *   about: 'Delicious food served daily'
+     * });
+     */
+    getUploadHandle(uploadId: string): Promise<UploadHandle>;
+}
+
+export { BusinessProfileApi as B, type CreateUploadSessionParams as C, type GetUploadHandleParams as G, type UpdateBusinessProfileRequest as U, BusinessProfileClass as a, type BusinessProfileData as b, type BusinessProfileField as c, type BusinessProfileFieldsParam as d, type BusinessProfileResponse as e, type UploadBusinessProfileResponse as f, type UploadHandle as g, type UploadMediaParams as h, type UploadSession as i, type UploadSessionResponse as j };

package/dist/EncryptionApi-D7pt-OXT.d.ts

@@ -0,0 +1,22 @@
+import { B as BaseAPI } from './base-CdGDdVEl.js';
+import { WabaConfigType } from './types/config.js';
+import { c as ResponseData, e as ResponseSuccess, R as RequesterClass } from './request-vYMaEfk5.js';
+
+type EncryptionPublicKeyResponse = ResponseData<{
+    business_public_key: string;
+    business_public_key_signature_status: 'VALID' | 'MISMATCH';
+}>;
+
+interface EncryptionClass {
+    getEncryptionPublicKey(): Promise<EncryptionPublicKeyResponse>;
+    setEncryptionPublicKey(businessPublicKey: string): Promise<ResponseSuccess>;
+}
+
+declare class EncryptionApi extends BaseAPI implements EncryptionClass {
+    private readonly endpoint;
+    constructor(config: WabaConfigType, client: RequesterClass);
+    getEncryptionPublicKey(): Promise<EncryptionPublicKeyResponse>;
+    setEncryptionPublicKey(businessPublicKey: string): Promise<ResponseSuccess>;
+}
+
+export { EncryptionApi as E, type EncryptionClass as a, type EncryptionPublicKeyResponse as b };

package/dist/FlowApi-UAvzhJfV.d.ts

@@ -0,0 +1,136 @@
+import { B as BaseAPI } from './base-CdGDdVEl.js';
+import { WabaConfigType } from './types/config.js';
+import { R as RequesterClass, e as ResponseSuccess } from './request-vYMaEfk5.js';
+import { e as FlowClass, j as FlowsListResponse, d as FlowCategoryEnum, C as CreateFlowResponse, F as Flow, i as FlowPreviewResponse, c as FlowAssetsResponse, U as UpdateFlowResponse, V as ValidateFlowJsonResponse, h as FlowMigrationResponse } from './common-DDXsNyLF.js';
+
+/**
+ * API for managing WhatsApp Flows.
+ *
+ * This API allows you to:
+ * - List flows
+ * - Create flows
+ * - Get flow details and previews
+ * - Update flow metadata and JSON
+ * - Delete flows
+ * - Publish and deprecate flows
+ * - Migrate flows between WABAs
+ * - Validate flow JSON
+ */
+declare class FlowApi extends BaseAPI implements FlowClass {
+    constructor(config: WabaConfigType, client: RequesterClass);
+    /**
+     * List Flows
+     *
+     * @param wabaId - The WABA ID
+     * @returns Promise with the list of flows
+     */
+    listFlows(wabaId: string): Promise<FlowsListResponse>;
+    /**
+     * Create Flow
+     *
+     * @param wabaId - The WABA ID
+     * @param data - The flow data including name, categories, endpoint_uri, and optional clone_flow_id
+     * @returns Promise with the created flow ID and validation errors if any
+     */
+    createFlow(wabaId: string, data: {
+        name: string;
+        categories?: FlowCategoryEnum[];
+        endpoint_uri?: string;
+        clone_flow_id?: string;
+        flow_json?: string;
+        publish?: boolean;
+    }): Promise<CreateFlowResponse>;
+    /**
+     * Get Flow details
+     *
+     * @param flowId - The flow ID
+     * @param fields - Optional fields to return (e.g., 'name,status,preview.invalidate(false)')
+     * @param dateFormat - Optional date format
+     * @returns Promise with the flow details or preview response
+     */
+    getFlow(flowId: string, fields?: string, dateFormat?: string): Promise<Flow | FlowPreviewResponse>;
+    /**
+     * Get Flow Preview URL
+     *
+     * @param flowId - The flow ID
+     * @param invalidate - Optional. If true, invalidates existing preview and generates a new one. Defaults to false.
+     * @returns Promise with the flow preview details
+     */
+    getFlowPreview(flowId: string, invalidate?: boolean): Promise<FlowPreviewResponse>;
+    /**
+     * Update Flow Metadata
+     *
+     * @param flowId - The flow ID
+     * @param data - The flow metadata to update (name, categories, endpoint_uri, application_id)
+     * @returns Promise with the success status
+     */
+    updateFlowMetadata(flowId: string, data: {
+        name?: string;
+        categories?: FlowCategoryEnum[];
+        endpoint_uri?: string;
+        application_id?: string;
+    }): Promise<ResponseSuccess>;
+    /**
+     * Delete Flow (only works if the Flow is in DRAFT status)
+     *
+     * @param flowId - The flow ID
+     * @returns Promise with the success status
+     */
+    deleteFlow(flowId: string): Promise<ResponseSuccess>;
+    /**
+     * List Assets (e.g., get Flow JSON download URL)
+     *
+     * @param flowId - The flow ID
+     * @returns Promise with the list of assets
+     */
+    listAssets(flowId: string): Promise<FlowAssetsResponse>;
+    /**
+     * Update Flow JSON by uploading a file, buffer, JSON object, or Blob.
+     *
+     * @param flowId - The flow ID
+     * @param data - Object containing the file data and optional name.
+     * @param data.file - The Flow JSON content as a Buffer, JSON object, or Blob.
+     * @param data.name - Optional name for the asset, defaults to 'flow.json'.
+     * @returns Promise with the success status and validation errors, if any.
+     */
+    updateFlowJson(flowId: string, data: {
+        file: Blob | Buffer | object;
+        name?: string;
+    }): Promise<UpdateFlowResponse>;
+    /**
+     * Validate Flow JSON by attempting an update without publishing.
+     * This is a convenience method; the API doesn't have a dedicated validation endpoint.
+     *
+     * @param flowId - The ID of the Flow (must exist, can be in DRAFT status).
+     * @param flowJsonData - The Flow JSON content as a file path (string), Buffer, JSON object, or Blob.
+     * @returns Promise indicating if the JSON is valid and includes validation errors if any.
+     */
+    validateFlowJson(flowId: string, flowJsonData: Blob | Buffer | object): Promise<ValidateFlowJsonResponse>;
+    /**
+     * Publish Flow
+     *
+     * @param flowId - The flow ID
+     * @returns Promise with the success status
+     */
+    publishFlow(flowId: string): Promise<ResponseSuccess>;
+    /**
+     * Deprecate Flow
+     *
+     * @param flowId - The flow ID
+     * @returns Promise with the success status
+     */
+    deprecateFlow(flowId: string): Promise<ResponseSuccess>;
+    /**
+     * Migrate Flows between WABAs
+     *
+     * @param destinationWabaId - The destination WABA ID
+     * @param data - The migration data including source_waba_id and optional source_flow_names
+     * @returns Promise with migration results (successes and failures)
+     */
+    migrateFlows(destinationWabaId: string, data: {
+        source_waba_id: string;
+        source_flow_names?: string[];
+    }): Promise<FlowMigrationResponse>;
+}
+
+export { FlowApi as F };

package/dist/MediaApi-BrEKpqi_.d.ts

@@ -0,0 +1,90 @@
+import { B as BaseAPI } from './base-CdGDdVEl.js';
+import { WabaConfigType } from './types/config.js';
+import { e as ResponseSuccess, R as RequesterClass } from './request-vYMaEfk5.js';
+
+type MediaResponse = {
+    id: string;
+    url: string;
+    mime_type: string;
+    sha256: string;
+    file_size: number;
+    messaging_product: 'whatsapp';
+};
+type MediasResponse = {
+    data: MediaResponse[];
+    paging: {
+        cursors: {
+            before: string;
+            after: string;
+        };
+    };
+};
+type UploadMediaResponse = {
+    id: string;
+};
+interface MediaClass {
+    getMediaById(mediaId: string, phone_number_id?: string): Promise<MediaResponse>;
+    uploadMedia(file: File, messagingProduct?: string): Promise<UploadMediaResponse>;
+    deleteMedia(mediaId: string, phone_number_id?: string): Promise<ResponseSuccess>;
+    downloadMedia(mediaUrl: string): Promise<Blob>;
+}
+
+/**
+ * API for managing WhatsApp Media.
+ *
+ * This API allows you to:
+ * - Get media information by ID
+ * - Upload media files
+ * - Delete media files
+ * - Download media files from URLs
+ */
+declare class MediaApi extends BaseAPI implements MediaClass {
+    private readonly endpoint;
+    constructor(config: WabaConfigType, client: RequesterClass);
+    /**
+     * Retrieve media information by media ID.
+     *
+     * @param mediaId The media ID to retrieve information for
+     * @param phone_number_id Optional phone number ID (defaults to configured one)
+     * @returns Media information including URL, mime type, file size, etc.
+     *
+     * @example
+     * const mediaInfo = await whatsappClient.media.getMediaById('media_id_123');
+     */
+    getMediaById(mediaId: string, phone_number_id?: string): Promise<MediaResponse>;
+    /**
+     * Upload a media file to WhatsApp.
+     *
+     * @param file The file to upload
+     * @param messagingProduct The messaging product (default: 'whatsapp')
+     * @returns Upload response containing the media ID
+     *
+     * @example
+     * const file = new File([buffer], 'image.jpg', { type: 'image/jpeg' });
+     * const result = await whatsappClient.media.uploadMedia(file);
+     */
+    uploadMedia(file: File, messagingProduct?: string): Promise<UploadMediaResponse>;
+    /**
+     * Delete a media file.
+     *
+     * @param mediaId The media ID to delete
+     * @param phone_number_id Optional phone number ID (defaults to configured one)
+     * @returns Response indicating success or failure
+     *
+     * @example
+     * await whatsappClient.media.deleteMedia('media_id_123');
+     */
+    deleteMedia(mediaId: string, phone_number_id?: string): Promise<ResponseSuccess>;
+    /**
+     * Download media from a URL.
+     *
+     * @param mediaUrl The URL to download media from
+     * @returns Blob containing the media data
+     *
+     * @example
+     * const blob = await whatsappClient.media.downloadMedia('https://...');
+     */
+    downloadMedia(mediaUrl: string): Promise<Blob>;
+}
+
+export { MediaApi as M, type UploadMediaResponse as U, type MediaClass as a, type MediaResponse as b, type MediasResponse as c };