meta-cloud-api 0.2.44 → 1.0.1

package/README.md

@@ -18,10 +18,11 @@
 ## Features
 
 - **Type-Safe Development** - Built with TypeScript to provide code completion and catch errors during development
-- **Comprehensive Coverage** - Full support for WhatsApp Business Platform APIs
-- **Clean Interface** - Intuitive methods organized by domain for improved code readability
+- **Comprehensive Coverage** - Full support for WhatsApp Business Platform APIs including Messages, Media, Templates, Flows, and more
+- **Modular Architecture** - Clean separation of concerns with dedicated API classes for each domain
+- **Framework-Specific Webhooks** - Built-in support for Express.js and Next.js webhook handling
+- **Advanced Features** - Support for Flows, Encryption, QR Codes, Two-Step Verification, and WABA management
 - **Error Handling** - Standardized error handling with detailed Meta API error information
-- **Webhook Handler** - Built-in support for webhook verification and message handling
 
 ## Installation
 
@@ -58,8 +59,6 @@ console.log(`Message ID: ${response.messages[0].id}`);
 
 ### Messaging
 
-Send different types of messages through WhatsApp Business Platform:
-
 #### Text Message
 
 ```typescript
@@ -146,71 +145,96 @@ const result = await client.messages.interactive({
 });
 ```
 
-## Example Projects
+### Webhook Integration
 
-We provide ready-to-use example projects demonstrating how to integrate Meta Cloud API in different frameworks:
+#### Express.js Webhook
 
-- [Express.js Example](./examples/express-example) - A simple Express.js server with webhook handling for WhatsApp messages
-- [Next.js Example](./examples/nextjs-page-router-example) - Integration with Next.js Pages Router, showing how to handle webhooks in a Next.js API route
+```typescript
+import express from 'express';
+import { MessageTypesEnum } from 'meta-cloud-api';
+import { webhookHandler } from 'meta-cloud-api/webhook/express';
 
-Each example includes its own README with setup instructions and demonstration of core features.
+const app = express();
 
-### Webhook Integration
+// Create webhook handler
+const bot = webhookHandler({
+  accessToken: process.env.CLOUD_API_ACCESS_TOKEN!,
+  phoneNumberId: parseInt(process.env.WA_PHONE_NUMBER_ID!),
+  webhookVerificationToken: process.env.WEBHOOK_VERIFICATION_TOKEN!,
+});
+
+// Handle text messages
+bot.processor.onMessage(MessageTypesEnum.Text, async (whatsapp, message) => {
+  await whatsapp.messages.text({
+    to: message.from,
+    body: `Echo: ${message.text?.body}`,
+  });
+});
+
+// Setup webhook endpoints
+app.get('/webhook', bot.webhook);
+app.post('/webhook', express.json(), bot.webhook);
 
-Set up a webhook to receive messages and events from the WhatsApp API:
+app.listen(3000);
+```
+
+#### Next.js Webhook
 
 ```typescript
-import WhatsApp, { 
-  WebhookHandler, 
-  MessageTypesEnum, 
-  WebhookMessage 
-} from 'meta-cloud-api';
-
-// Initialize the handler
-const webhookHandler = new WebhookHandler({
-  accessToken: process.env.CLOUD_API_ACCESS_TOKEN,
-  phoneNumberId: Number(process.env.WA_PHONE_NUMBER_ID),
-  businessAcctId: process.env.WA_BUSINESS_ACCOUNT_ID,
-  webhookVerificationToken: process.env.WEBHOOK_VERIFICATION_TOKEN
+// pages/api/webhook.ts
+import { NextApiRequest, NextApiResponse } from 'next';
+import { MessageTypesEnum } from 'meta-cloud-api';
+import { webhookHandler } from 'meta-cloud-api/webhook/nextjs';
+
+const bot = webhookHandler({
+  accessToken: process.env.CLOUD_API_ACCESS_TOKEN!,
+  phoneNumberId: parseInt(process.env.WA_PHONE_NUMBER_ID!),
+  webhookVerificationToken: process.env.WEBHOOK_VERIFICATION_TOKEN!,
 });
 
-// Handle webhook verification
-app.get('/webhook', (req, res) => {
-  webhookHandler.handleVerificationRequest(req, res);
+// Handle text messages
+bot.processor.onMessage(MessageTypesEnum.Text, async (whatsapp, message) => {
+  await whatsapp.messages.text({
+    to: message.from,
+    body: `Echo: ${message.text?.body}`,
+  });
 });
 
-// Handle incoming messages
-app.post('/webhook', (req, res) => {
-  webhookHandler.handleWebhookRequest(req, res);
-});
+export default async function handler(req: NextApiRequest, res: NextApiResponse) {
+  return bot.webhook(req, res);
+}
+```
+
+### Advanced Message Handling
+
+```typescript
+import { MessageTypesEnum } from 'meta-cloud-api';
 
 // Pre-process all messages (e.g., mark as read)
-webhookHandler.onMessagePreProcess(async (client: WhatsApp, message: WebhookMessage) => {
-  await client.messages.markAsRead({ messageId: message.id });
+bot.processor.onMessagePreProcess(async (whatsapp, message) => {
+  await whatsapp.messages.markAsRead({ messageId: message.id });
 });
 
-// Handle text messages
-webhookHandler.onMessage(MessageTypesEnum.Text, async (client: WhatsApp, message: WebhookMessage) => {
-  if (message.text?.body) {
-    await client.messages.text({
-      body: `You said: "${message.text.body}"`,
-      to: message.from
-    });
-  }
+// Handle different message types
+bot.processor.onMessage(MessageTypesEnum.Text, async (whatsapp, message) => {
+  // Handle text messages
 });
 
-// Handle image messages
-webhookHandler.onMessage(MessageTypesEnum.Image, async (client: WhatsApp, message: WebhookMessage) => {
-  await client.messages.text({
-    body: "Thanks for the image!",
-    to: message.from
-  });
+bot.processor.onMessage(MessageTypesEnum.Image, async (whatsapp, message) => {
+  // Handle image messages
+});
+
+bot.processor.onMessage(MessageTypesEnum.Document, async (whatsapp, message) => {
+  // Handle document messages
 });
-```
 
-### Templates
+// Handle message status updates
+bot.processor.onMessageStatus(async (whatsapp, status) => {
+  console.log(`Message ${status.id} status: ${status.status}`);
+});
+```
 
-Manage message templates for your WhatsApp Business account:
+### Templates Management
 
 ```typescript
 // List all templates
@@ -221,21 +245,17 @@ const templates = await client.templates.list({
 // Create a new template
 const newTemplate = await client.templates.create({
   businessId: process.env.WA_BUSINESS_ACCOUNT_ID,
-  name: "my_special_template",
+  name: "welcome_message",
   category: "MARKETING",
   components: [
     {
       type: "HEADER",
       format: "TEXT",
-      text: "Special Offer"
+      text: "Welcome!"
     },
     {
       type: "BODY",
-      text: "Hi {{1}}, we have a special offer for you: {{2}}% off your next purchase!"
-    },
-    {
-      type: "FOOTER",
-      text: "Tap the button below to shop now"
+      text: "Hi {{1}}, welcome to our service!"
     }
   ],
   language: "en_US"
@@ -244,8 +264,6 @@ const newTemplate = await client.templates.create({
 
 ### Media Management
 
-Upload and retrieve media for your messages:
-
 ```typescript
 import fs from 'fs';
 
@@ -259,13 +277,17 @@ const mediaUpload = await client.media.upload({
 const media = await client.media.get({
   mediaId: mediaUpload.id
 });
-```
 
-### Business Profile
+// Download media
+const mediaBuffer = await client.media.download({
+  mediaId: mediaUpload.id
+});
+```
 
-Update your WhatsApp Business profile information:
+### Business Profile Management
 
 ```typescript
+// Update business profile
 const profile = await client.businessProfile.update({
   about: "We provide the best service!",
   address: "123 Business St, City",
@@ -273,12 +295,106 @@ const profile = await client.businessProfile.update({
   email: "contact@business.com",
   websites: ["https://www.business.com"]
 });
+
+// Get current profile
+const currentProfile = await client.businessProfile.get();
+```
+
+### WhatsApp Flows
+
+```typescript
+// Create a flow
+const flow = await client.flows.create({
+  name: "Customer Survey",
+  categories: ["SURVEY"],
+  clone_flow_id: "existing_flow_id" // Optional
+});
+
+// Update flow
+const updatedFlow = await client.flows.update({
+  flowId: flow.id,
+  name: "Updated Survey",
+  categories: ["SURVEY", "FEEDBACK"]
+});
+```
+
+## Example Projects
+
+We provide ready-to-use example projects demonstrating integration with different frameworks:
+
+### [Express.js Echo Bot](./examples/express-example)
+A simple echo bot that responds to any text message. Perfect for getting started!
+
+```bash
+cd examples/express-example
+npm install
+cp env.example .env  # Configure your credentials
+npm run dev
+```
+
+### [Next.js Echo Bot](./examples/nextjs-page-router-example)
+Next.js implementation with API routes for webhook handling.
+
+```bash
+cd examples/nextjs-page-router-example
+npm install
+cp env.example .env.local  # Configure your credentials
+npm run dev
+```
+
+## Modular Imports
+
+Use specific imports for better tree-shaking:
+
+```typescript
+// Import specific API classes
+import { MessagesApi } from 'meta-cloud-api/messages';
+import { MediaApi } from 'meta-cloud-api/media';
+import { TemplateApi } from 'meta-cloud-api/template';
+
+// Import specific webhook handlers
+import { webhookHandler } from 'meta-cloud-api/webhook/express';
+import { webhookHandler } from 'meta-cloud-api/webhook/nextjs';
+
+// Import types and enums
+import { MessageTypesEnum, InteractiveTypesEnum } from 'meta-cloud-api/types/enums';
+import type { WhatsAppConfig } from 'meta-cloud-api/types/config';
+```
+
+## Configuration
+
+```typescript
+interface WhatsAppConfig {
+  accessToken: string;           // Required: Meta Cloud API access token
+  phoneNumberId: number;         // Required: WhatsApp phone number ID
+  businessAcctId?: string;       // Optional: Business account ID
+  apiVersion?: string;           // Optional: API version (default: v21.0)
+  webhookVerificationToken?: string; // Optional: For webhook verification
+  requestTimeout?: number;       // Optional: Request timeout in ms
+}
+```
+
+## Error Handling
+
+```typescript
+try {
+  const result = await client.messages.text({
+    to: "15551234567",
+    body: "Hello World"
+  });
+} catch (error) {
+  if (error.response?.data?.error) {
+    console.error('Meta API Error:', error.response.data.error);
+  } else {
+    console.error('Network Error:', error.message);
+  }
+}
 ```
 
 ## Requirements
 
-- TypeScript 4.5+
-- Node.js 18 LTS or later
+- **Node.js** 18 LTS or later
+- **TypeScript** 4.5+ (for TypeScript projects)
 
 ## Contributing
 

package/dist/{BusinessProfileApi-DE7Nnuy_.d.ts → BusinessProfileApi-WXscSgo-.d.ts}

@@ -1,6 +1,7 @@
-import { d as BaseClass, R as ResponseSuccess, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
-import { B as BusinessVerticalEnum } from './enums-DvwSJq9w.js';
+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.

package/dist/{EncryptionApi-PHxeI2G_.d.ts → EncryptionApi-D7pt-OXT.d.ts}

@@ -1,5 +1,6 @@
-import { c as ResponseData, R as ResponseSuccess, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
+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;

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-B2vtjiCm.d.ts → MediaApi-BrEKpqi_.d.ts}

@@ -1,5 +1,6 @@
-import { R as ResponseSuccess, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
+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;

package/dist/{MessageApi-ptFlWg3O.d.ts → MessageApi-Circorzz.d.ts}

@@ -1,6 +1,7 @@
-import { d as BaseClass, G as GeneralRequestBody, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
-import { I as InteractiveTypesEnum, c as ComponentTypesEnum, L as LanguagesEnum, P as ParametersTypesEnum, C as CurrencyCodesEnum, S as SubTypeEnum, b as ButtonPositionEnum, M as MessageTypesEnum } from './enums-DvwSJq9w.js';
+import { a as BaseClass, B as BaseAPI } from './base-CdGDdVEl.js';
+import { WabaConfigType } from './types/config.js';
+import { I as InteractiveTypesEnum, C as ComponentTypesEnum, L as LanguagesEnum, P as ParametersTypesEnum, i as CurrencyCodesEnum, S as SubTypeEnum, B as ButtonPositionEnum, M as MessageTypesEnum } from './enums-BZd9T2ul.js';
+import { a as GeneralRequestBody, R as RequesterClass } from './request-vYMaEfk5.js';
 
 interface ReactionParams {
     messageId: string;

package/dist/{PhoneNumberApi-DMb_G3uw.d.ts → PhoneNumberApi-DKlu9PHl.d.ts}

@@ -1,5 +1,6 @@
-import { P as Paging, R as ResponseSuccess, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
+import { B as BaseAPI } from './base-CdGDdVEl.js';
+import { WabaConfigType } from './types/config.js';
+import { P as Paging, e as ResponseSuccess, R as RequesterClass } from './request-vYMaEfk5.js';
 
 type QualityRating = 'GREEN' | 'YELLOW' | 'RED' | 'NA';
 type AccountMode = 'LIVE' | 'SANDBOX';
@@ -80,7 +81,7 @@ interface PhoneNumberClass {
 }
 
 /**
- * API for managing WhatsApp Phone Numbers.
+ * API for managing WhatsApp Phone Numb ers.
  *
  * This API allows you to:
  * - Get phone number information by ID

package/dist/{QrCodeApi-D3rVKuxV.d.ts → QrCodeApi-7vDwIBHR.d.ts}

@@ -1,5 +1,6 @@
-import { c as ResponseData, R as ResponseSuccess, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
+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 QrCodeResponse = {
     code: string;

package/dist/{RegistrationApi-DZBJWAZS.d.ts → RegistrationApi-qO_qoti9.d.ts}

@@ -1,6 +1,7 @@
-import { R as ResponseSuccess, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
-import { D as DataLocalizationRegionEnum } from './enums-DvwSJq9w.js';
+import { B as BaseAPI } from './base-CdGDdVEl.js';
+import { WabaConfigType } from './types/config.js';
+import { j as DataLocalizationRegionEnum } from './enums-BZd9T2ul.js';
+import { e as ResponseSuccess, R as RequesterClass } from './request-vYMaEfk5.js';
 
 type RegistrationRequest = {
     messaging_product: 'whatsapp';

package/dist/{TemplateApi-BFeM9qJS.d.ts → TemplateApi-xGgIZt89.d.ts}

@@ -1,6 +1,7 @@
-import { G as GeneralRequestBody, R as ResponseSuccess, b as ResponsePagination, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
-import { L as LanguagesEnum, a as CategoryEnum, T as TemplateStatusEnum } from './enums-DvwSJq9w.js';
+import { B as BaseAPI } from './base-CdGDdVEl.js';
+import { WabaConfigType } from './types/config.js';
+import { a as GeneralRequestBody, e as ResponseSuccess, d as ResponsePagination, R as RequesterClass } from './request-vYMaEfk5.js';
+import { L as LanguagesEnum, a as CategoryEnum, T as TemplateStatusEnum } from './enums-BZd9T2ul.js';
 
 type TemplateFormat = 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT' | 'LOCATION' | 'PRODUCT';
 type PhoneNumberButton = {
@@ -157,4 +158,4 @@ declare class TemplateApi extends BaseAPI implements TemplateClass {
     deleteTemplate(params: TemplateDeleteParams): Promise<ResponseSuccess>;
 }
 
-export { type CatalogButton as C, type FlowButton as F, type MPMButton as M, type OTPButton as O, type PhoneNumberButton as P, type QuickReplyButton as Q, type SPMButton as S, type TemplateFormat as T, type URLButton as U, type TemplateRequestBody as a, TemplateClass as b, type TemplateDeleteParams as c, type TemplateGetParams as d, type TemplateResponse as e, TemplateApi as f, type ComponentTypes as g, type CopyCodeButton as h, type TemplateBody as i, type TemplateButton as j, type TemplateButtons as k, type TemplateCarousel as l, type TemplateFooter as m, type TemplateHeader as n, type TemplateHeaderExample as o, type TemplateLimitedTimeOffer as p, type MediaCarouselCard as q, type ProductCarouselCard as r };
+export { type CatalogButton as C, type FlowButton as F, type MPMButton as M, type OTPButton as O, type PhoneNumberButton as P, type QuickReplyButton as Q, type SPMButton as S, TemplateApi as T, type URLButton as U, TemplateClass as a, type TemplateDeleteParams as b, type TemplateGetParams as c, type TemplateRequestBody as d, type TemplateResponse as e, type TemplateFormat as f, type ComponentTypes as g, type CopyCodeButton as h, type TemplateBody as i, type TemplateButton as j, type TemplateButtons as k, type TemplateCarousel as l, type TemplateFooter as m, type TemplateHeader as n, type TemplateHeaderExample as o, type TemplateLimitedTimeOffer as p, type MediaCarouselCard as q, type ProductCarouselCard as r };

package/dist/{TwoStepVerificationApi-6jV5pDxS.d.ts → TwoStepVerificationApi-DfNPIz-C.d.ts}

@@ -1,5 +1,6 @@
-import { R as ResponseSuccess, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
+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 TwoStepVerificationRequest = {
     pin: string;

package/dist/{WabaApi-B8Gv2UNE.d.ts → WabaApi-DqQi_68m.d.ts}

@@ -1,5 +1,6 @@
-import { R as ResponseSuccess, B as BaseAPI, a as RequesterClass } from './base-BhCbbsxB.js';
-import { WabaConfigType } from './shared/types/config.js';
+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';
 
 /**
  * WhatsApp Business Account subscription configuration

package/dist/{WebhookHandler-Bxxi6SdT.d.ts → WebhookProcessor-ByAe7Kf_.d.ts}

@@ -1,7 +1,7 @@
-import { g as FlowEndpointRequest, n as FlowTypeEnum } from './FlowApi-CASVC-Al.js';
-import { WabaConfigType, WhatsAppConfig } from './shared/types/config.js';
-import { M as MessageTypesEnum } from './enums-DvwSJq9w.js';
-import { W as WhatsApp } from './index-DiCI1vEz.js';
+import { f as FlowEndpointRequest, l as FlowTypeEnum } from './common-DDXsNyLF.js';
+import { WabaConfigType, WhatsAppConfig } from './types/config.js';
+import { M as MessageTypesEnum } from './enums-BZd9T2ul.js';
+import { W as WhatsApp } from './WhatsApp-BIBtT-y9.js';
 
 interface WebhookContact {
     /**
@@ -672,11 +672,20 @@ declare function processWebhookMessages(request: Request, whatsapp: WhatsApp, ha
  * Handle flow requests
  */
 declare function processFlowRequest(request: Request, config: WabaConfigType, whatsapp: WhatsApp, flowHandlers: Map<FlowTypeEnum, FlowHandler>): Promise<Response>;
-
 /**
- * WebhookHandler based on Web Standard API
+ * Constructs a full URL from framework-specific request headers and URL
+ * @param headers - Request headers containing host and protocol information
+ * @param url - Relative URL path
+ * @returns Full URL string
  */
-declare class WebhookHandler {
+declare function constructFullUrl(headers: Record<string, string | string[] | undefined>, url?: string): string;
+
+interface WebhookResponse {
+    status: number;
+    body: string;
+    headers: Record<string, string>;
+}
+declare class WebhookProcessor {
     private config;
     private client;
     private messageHandlers;
@@ -684,34 +693,15 @@ declare class WebhookHandler {
     private postProcessHandler;
     private flowHandlers;
     constructor(config: WhatsAppConfig);
-    /**
-     * Handle webhook requests using Web Standard API
-     */
-    handleWebhook(request: Request): Promise<Response>;
-    /**
-     * Handle flow requests
-     */
-    handleFlow(request: Request): Promise<Response>;
-    /**
-     * Verify webhook signature
-     */
-    private verifySignature;
-    /**
-     * Register a message handler for a specific message type
-     */
+    processVerification(mode: string | null, token: string | null, challenge: string | null): Promise<WebhookResponse>;
+    processWebhook(request: Request): Promise<WebhookResponse>;
+    processFlow(request: Request): Promise<WebhookResponse>;
     onMessage(type: MessageTypesEnum, handler: MessageHandler): void;
-    /**
-     * Register a pre-process handler that runs before all message handlers
-     */
     onMessagePreProcess(handler: MessageHandler): void;
-    /**
-     * Register a post-process handler that runs after all message handlers
-     */
     onMessagePostProcess(handler: MessageHandler): void;
-    /**
-     * Register a flow handler for a specific flow type
-     */
     onFlow(type: FlowTypeEnum, handler: FlowHandler): void;
+    getClient(): WhatsApp;
+    getConfig(): WabaConfigType;
 }
 
-export { type FlowHandler as F, MessageStatus as M, type WebhookContact as W, type WebhookEvent as a, type WebhookMessage as b, WebhookHandler as c, type MessageHandler as d, processFlowRequest as e, processWebhookMessages as p };
+export { type FlowHandler as F, MessageStatus as M, type WebhookContact as W, type WebhookEvent as a, type WebhookMessage as b, WebhookProcessor as c, type WebhookResponse as d, type MessageHandler as e, processFlowRequest as f, constructFullUrl as g, processWebhookMessages as p };