waba-toolkit 0.3.1 → 0.4.0

package/dist/index.d.mts

@@ -158,6 +158,102 @@ interface PhoneNumber {
 interface ListPhoneNumbersResponse {
     data: PhoneNumber[];
 }
+type FlowCategory = 'SIGN_UP' | 'SIGN_IN' | 'APPOINTMENT_BOOKING' | 'LEAD_GENERATION' | 'CONTACT_US' | 'CUSTOMER_SUPPORT' | 'SURVEY' | 'OTHER';
+interface CreateFlowOptions {
+    name: string;
+    categories?: FlowCategory[];
+    endpointUri?: string;
+    cloneFlowId?: string;
+}
+interface CreateFlowResponse {
+    id: string;
+}
+interface FlowValidationError {
+    error: string;
+    error_type: string;
+    message: string;
+    line_start: number;
+    line_end: number;
+    column_start: number;
+    column_end: number;
+}
+interface UpdateFlowJsonResponse {
+    success: boolean;
+    validation_errors: FlowValidationError[];
+}
+interface PublishFlowResponse {
+    success: boolean;
+}
+type FlowStatus = 'DRAFT' | 'PUBLISHED' | 'DEPRECATED' | 'BLOCKED' | 'THROTTLED';
+interface FlowListItem {
+    id: string;
+    name: string;
+    status: FlowStatus;
+    categories: FlowCategory[];
+    validation_errors: FlowValidationError[];
+}
+interface ListFlowsResponse {
+    data: FlowListItem[];
+    paging?: {
+        cursors: {
+            before: string;
+            after: string;
+        };
+    };
+}
+type TemplateCategory = 'AUTHENTICATION' | 'MARKETING' | 'UTILITY';
+type TemplateStatus = 'APPROVED' | 'IN_APPEAL' | 'PENDING' | 'REJECTED' | 'PENDING_DELETION' | 'DELETED' | 'DISABLED' | 'PAUSED' | 'LIMIT_EXCEEDED';
+interface TemplateComponentDefinition {
+    type: 'HEADER' | 'BODY' | 'FOOTER' | 'BUTTONS';
+    format?: 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT' | 'LOCATION';
+    text?: string;
+    buttons?: Array<{
+        type: string;
+        text?: string;
+        url?: string;
+        phone_number?: string;
+        [key: string]: unknown;
+    }>;
+    example?: {
+        header_text?: string[];
+        header_handle?: string[];
+        body_text?: string[][];
+    };
+    [key: string]: unknown;
+}
+interface TemplateListItem {
+    id: string;
+    name: string;
+    language: string;
+    status: TemplateStatus;
+    category: TemplateCategory;
+    previous_category?: TemplateCategory;
+    components: TemplateComponentDefinition[];
+}
+interface ListTemplatesResponse {
+    data: TemplateListItem[];
+    paging?: {
+        cursors: {
+            before: string;
+            after: string;
+        };
+    };
+}
+interface CreateTemplateRequest {
+    name: string;
+    language: string;
+    category: TemplateCategory;
+    components: TemplateComponentDefinition[];
+    allow_category_change?: boolean;
+}
+interface CreateTemplateResponse {
+    id: string;
+    status: TemplateStatus;
+    category: TemplateCategory;
+}
+interface DeleteTemplateResponse {
+    success: boolean;
+}
 
 interface WABAApiClientOptions {
     accessToken: string;
@@ -229,6 +325,78 @@ declare class WABAApiClient {
      * @throws {WABANetworkError} - Network/connection failures
      */
     sendMessage(payload: MessagePayload): Promise<SendMessageResponse>;
+    /**
+     * Create a new WhatsApp Flow.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @param options - Flow creation options
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Flow creation failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    createFlow(wabaId: string, options: CreateFlowOptions): Promise<CreateFlowResponse>;
+    /**
+     * Upload or update Flow JSON for an existing flow.
+     *
+     * @param flowId - Flow ID to update
+     * @param filePath - Path to the Flow JSON file
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Flow update failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    updateFlowJson(flowId: string, filePath: string): Promise<UpdateFlowJsonResponse>;
+    /**
+     * Publish a flow. This action is irreversible.
+     * Once published, the flow and its assets become immutable.
+     * To update a published flow, create a new flow with clone_flow_id.
+     *
+     * @param flowId - Flow ID to publish
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Flow publish failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    publishFlow(flowId: string): Promise<PublishFlowResponse>;
+    /**
+     * List all flows for a WhatsApp Business Account.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Request failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    listFlows(wabaId: string): Promise<ListFlowsResponse>;
+    /**
+     * List all message templates for a WhatsApp Business Account.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Request failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    listTemplates(wabaId: string): Promise<ListTemplatesResponse>;
+    /**
+     * Create a new message template.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @param request - Template creation request
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Template creation failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    createTemplate(wabaId: string, request: CreateTemplateRequest): Promise<CreateTemplateResponse>;
+    /**
+     * Delete a message template by name.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @param templateName - Name of the template to delete
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Template deletion failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    deleteTemplate(wabaId: string, templateName: string): Promise<DeleteTemplateResponse>;
+    private makeGetRequest;
+    private makeDeleteRequest;
+    private makeFormDataRequest;
     private makeRequest;
 }
 
@@ -756,4 +924,4 @@ declare class WABASendError extends WABAError {
     constructor(message: string, statusCode: number, errorPayload: unknown);
 }
 
-export { type AudioMessage, type ButtonMessage, type ButtonReply, type CallEntry, type CallWebhookValue, type ContactCard, type ContactInfo, type ContactsMessage, type ConversationObject, type DeregisterPhoneRequest, type DocumentMessage, type GetMediaOptions, type ImageMessage, type IncomingMessage, type IncomingMessageBase, type InteractiveMessage, type ListPhoneNumbersResponse, type ListReply, type LocationMessage, type MediaBufferResult, type MediaMessage, type MediaMetadata, type MediaObject, type MediaStreamResult, type MessageClassification, type MessageContext, type MessagePayload, type MessageStatus, type MessageWebhookValue, type OrderMessage, type PhoneNumber, type PricingObject, type ReactionMessage, type ReferralMessage, type RegisterPhoneRequest, type SendMessageResponse, type SendTemplateMessageRequest, type SendTextMessageRequest, type StatusEntry, type StatusWebhookValue, type StickerMessage, type SuccessResponse, type SystemMessage, type TemplateComponent, type TemplateParameter, type TextMessage, type UnsupportedMessage, type VerifyWebhookSignatureOptions, type VideoMessage, WABAApiClient, type WABAApiClientOptions, WABAAuthError, WABAClient, type WABAClientOptions, WABAConfigError, WABAError, WABAMediaError, WABANetworkError, WABASendError, WABASignatureError, type WebhookChange, type WebhookClassification, type WebhookContact, type WebhookEntry, type WebhookError, type WebhookMetadata, type WebhookPayload, type WebhookValue, classifyMessage, classifyWebhook, extractMediaId, getCallId, getContactInfo, getMessageId, getMessageTimestamp, isMediaMessage, verifyWebhookSignature };
+export { type AudioMessage, type ButtonMessage, type ButtonReply, type CallEntry, type CallWebhookValue, type ContactCard, type ContactInfo, type ContactsMessage, type ConversationObject, type CreateFlowOptions, type CreateFlowResponse, type CreateTemplateRequest, type CreateTemplateResponse, type DeleteTemplateResponse, type DeregisterPhoneRequest, type DocumentMessage, type FlowCategory, type FlowListItem, type FlowStatus, type FlowValidationError, type GetMediaOptions, type ImageMessage, type IncomingMessage, type IncomingMessageBase, type InteractiveMessage, type ListFlowsResponse, type ListPhoneNumbersResponse, type ListReply, type ListTemplatesResponse, type LocationMessage, type MediaBufferResult, type MediaMessage, type MediaMetadata, type MediaObject, type MediaStreamResult, type MessageClassification, type MessageContext, type MessagePayload, type MessageStatus, type MessageWebhookValue, type OrderMessage, type PhoneNumber, type PricingObject, type PublishFlowResponse, type ReactionMessage, type ReferralMessage, type RegisterPhoneRequest, type SendMessageResponse, type SendTemplateMessageRequest, type SendTextMessageRequest, type StatusEntry, type StatusWebhookValue, type StickerMessage, type SuccessResponse, type SystemMessage, type TemplateCategory, type TemplateComponent, type TemplateComponentDefinition, type TemplateListItem, type TemplateParameter, type TemplateStatus, type TextMessage, type UnsupportedMessage, type UpdateFlowJsonResponse, type VerifyWebhookSignatureOptions, type VideoMessage, WABAApiClient, type WABAApiClientOptions, WABAAuthError, WABAClient, type WABAClientOptions, WABAConfigError, WABAError, WABAMediaError, WABANetworkError, WABASendError, WABASignatureError, type WebhookChange, type WebhookClassification, type WebhookContact, type WebhookEntry, type WebhookError, type WebhookMetadata, type WebhookPayload, type WebhookValue, classifyMessage, classifyWebhook, extractMediaId, getCallId, getContactInfo, getMessageId, getMessageTimestamp, isMediaMessage, verifyWebhookSignature };

package/dist/index.d.ts

@@ -158,6 +158,102 @@ interface PhoneNumber {
 interface ListPhoneNumbersResponse {
     data: PhoneNumber[];
 }
+type FlowCategory = 'SIGN_UP' | 'SIGN_IN' | 'APPOINTMENT_BOOKING' | 'LEAD_GENERATION' | 'CONTACT_US' | 'CUSTOMER_SUPPORT' | 'SURVEY' | 'OTHER';
+interface CreateFlowOptions {
+    name: string;
+    categories?: FlowCategory[];
+    endpointUri?: string;
+    cloneFlowId?: string;
+}
+interface CreateFlowResponse {
+    id: string;
+}
+interface FlowValidationError {
+    error: string;
+    error_type: string;
+    message: string;
+    line_start: number;
+    line_end: number;
+    column_start: number;
+    column_end: number;
+}
+interface UpdateFlowJsonResponse {
+    success: boolean;
+    validation_errors: FlowValidationError[];
+}
+interface PublishFlowResponse {
+    success: boolean;
+}
+type FlowStatus = 'DRAFT' | 'PUBLISHED' | 'DEPRECATED' | 'BLOCKED' | 'THROTTLED';
+interface FlowListItem {
+    id: string;
+    name: string;
+    status: FlowStatus;
+    categories: FlowCategory[];
+    validation_errors: FlowValidationError[];
+}
+interface ListFlowsResponse {
+    data: FlowListItem[];
+    paging?: {
+        cursors: {
+            before: string;
+            after: string;
+        };
+    };
+}
+type TemplateCategory = 'AUTHENTICATION' | 'MARKETING' | 'UTILITY';
+type TemplateStatus = 'APPROVED' | 'IN_APPEAL' | 'PENDING' | 'REJECTED' | 'PENDING_DELETION' | 'DELETED' | 'DISABLED' | 'PAUSED' | 'LIMIT_EXCEEDED';
+interface TemplateComponentDefinition {
+    type: 'HEADER' | 'BODY' | 'FOOTER' | 'BUTTONS';
+    format?: 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT' | 'LOCATION';
+    text?: string;
+    buttons?: Array<{
+        type: string;
+        text?: string;
+        url?: string;
+        phone_number?: string;
+        [key: string]: unknown;
+    }>;
+    example?: {
+        header_text?: string[];
+        header_handle?: string[];
+        body_text?: string[][];
+    };
+    [key: string]: unknown;
+}
+interface TemplateListItem {
+    id: string;
+    name: string;
+    language: string;
+    status: TemplateStatus;
+    category: TemplateCategory;
+    previous_category?: TemplateCategory;
+    components: TemplateComponentDefinition[];
+}
+interface ListTemplatesResponse {
+    data: TemplateListItem[];
+    paging?: {
+        cursors: {
+            before: string;
+            after: string;
+        };
+    };
+}
+interface CreateTemplateRequest {
+    name: string;
+    language: string;
+    category: TemplateCategory;
+    components: TemplateComponentDefinition[];
+    allow_category_change?: boolean;
+}
+interface CreateTemplateResponse {
+    id: string;
+    status: TemplateStatus;
+    category: TemplateCategory;
+}
+interface DeleteTemplateResponse {
+    success: boolean;
+}
 
 interface WABAApiClientOptions {
     accessToken: string;
@@ -229,6 +325,78 @@ declare class WABAApiClient {
      * @throws {WABANetworkError} - Network/connection failures
      */
     sendMessage(payload: MessagePayload): Promise<SendMessageResponse>;
+    /**
+     * Create a new WhatsApp Flow.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @param options - Flow creation options
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Flow creation failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    createFlow(wabaId: string, options: CreateFlowOptions): Promise<CreateFlowResponse>;
+    /**
+     * Upload or update Flow JSON for an existing flow.
+     *
+     * @param flowId - Flow ID to update
+     * @param filePath - Path to the Flow JSON file
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Flow update failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    updateFlowJson(flowId: string, filePath: string): Promise<UpdateFlowJsonResponse>;
+    /**
+     * Publish a flow. This action is irreversible.
+     * Once published, the flow and its assets become immutable.
+     * To update a published flow, create a new flow with clone_flow_id.
+     *
+     * @param flowId - Flow ID to publish
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Flow publish failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    publishFlow(flowId: string): Promise<PublishFlowResponse>;
+    /**
+     * List all flows for a WhatsApp Business Account.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Request failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    listFlows(wabaId: string): Promise<ListFlowsResponse>;
+    /**
+     * List all message templates for a WhatsApp Business Account.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Request failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    listTemplates(wabaId: string): Promise<ListTemplatesResponse>;
+    /**
+     * Create a new message template.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @param request - Template creation request
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Template creation failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    createTemplate(wabaId: string, request: CreateTemplateRequest): Promise<CreateTemplateResponse>;
+    /**
+     * Delete a message template by name.
+     *
+     * @param wabaId - WhatsApp Business Account ID
+     * @param templateName - Name of the template to delete
+     * @throws {WABAAuthError} - Authentication failure (invalid token)
+     * @throws {WABASendError} - Template deletion failure
+     * @throws {WABANetworkError} - Network/connection failures
+     */
+    deleteTemplate(wabaId: string, templateName: string): Promise<DeleteTemplateResponse>;
+    private makeGetRequest;
+    private makeDeleteRequest;
+    private makeFormDataRequest;
     private makeRequest;
 }
 
@@ -756,4 +924,4 @@ declare class WABASendError extends WABAError {
     constructor(message: string, statusCode: number, errorPayload: unknown);
 }
 
-export { type AudioMessage, type ButtonMessage, type ButtonReply, type CallEntry, type CallWebhookValue, type ContactCard, type ContactInfo, type ContactsMessage, type ConversationObject, type DeregisterPhoneRequest, type DocumentMessage, type GetMediaOptions, type ImageMessage, type IncomingMessage, type IncomingMessageBase, type InteractiveMessage, type ListPhoneNumbersResponse, type ListReply, type LocationMessage, type MediaBufferResult, type MediaMessage, type MediaMetadata, type MediaObject, type MediaStreamResult, type MessageClassification, type MessageContext, type MessagePayload, type MessageStatus, type MessageWebhookValue, type OrderMessage, type PhoneNumber, type PricingObject, type ReactionMessage, type ReferralMessage, type RegisterPhoneRequest, type SendMessageResponse, type SendTemplateMessageRequest, type SendTextMessageRequest, type StatusEntry, type StatusWebhookValue, type StickerMessage, type SuccessResponse, type SystemMessage, type TemplateComponent, type TemplateParameter, type TextMessage, type UnsupportedMessage, type VerifyWebhookSignatureOptions, type VideoMessage, WABAApiClient, type WABAApiClientOptions, WABAAuthError, WABAClient, type WABAClientOptions, WABAConfigError, WABAError, WABAMediaError, WABANetworkError, WABASendError, WABASignatureError, type WebhookChange, type WebhookClassification, type WebhookContact, type WebhookEntry, type WebhookError, type WebhookMetadata, type WebhookPayload, type WebhookValue, classifyMessage, classifyWebhook, extractMediaId, getCallId, getContactInfo, getMessageId, getMessageTimestamp, isMediaMessage, verifyWebhookSignature };
+export { type AudioMessage, type ButtonMessage, type ButtonReply, type CallEntry, type CallWebhookValue, type ContactCard, type ContactInfo, type ContactsMessage, type ConversationObject, type CreateFlowOptions, type CreateFlowResponse, type CreateTemplateRequest, type CreateTemplateResponse, type DeleteTemplateResponse, type DeregisterPhoneRequest, type DocumentMessage, type FlowCategory, type FlowListItem, type FlowStatus, type FlowValidationError, type GetMediaOptions, type ImageMessage, type IncomingMessage, type IncomingMessageBase, type InteractiveMessage, type ListFlowsResponse, type ListPhoneNumbersResponse, type ListReply, type ListTemplatesResponse, type LocationMessage, type MediaBufferResult, type MediaMessage, type MediaMetadata, type MediaObject, type MediaStreamResult, type MessageClassification, type MessageContext, type MessagePayload, type MessageStatus, type MessageWebhookValue, type OrderMessage, type PhoneNumber, type PricingObject, type PublishFlowResponse, type ReactionMessage, type ReferralMessage, type RegisterPhoneRequest, type SendMessageResponse, type SendTemplateMessageRequest, type SendTextMessageRequest, type StatusEntry, type StatusWebhookValue, type StickerMessage, type SuccessResponse, type SystemMessage, type TemplateCategory, type TemplateComponent, type TemplateComponentDefinition, type TemplateListItem, type TemplateParameter, type TemplateStatus, type TextMessage, type UnsupportedMessage, type UpdateFlowJsonResponse, type VerifyWebhookSignatureOptions, type VideoMessage, WABAApiClient, type WABAApiClientOptions, WABAAuthError, WABAClient, type WABAClientOptions, WABAConfigError, WABAError, WABAMediaError, WABANetworkError, WABASendError, WABASignatureError, type WebhookChange, type WebhookClassification, type WebhookContact, type WebhookEntry, type WebhookError, type WebhookMetadata, type WebhookPayload, type WebhookValue, classifyMessage, classifyWebhook, extractMediaId, getCallId, getContactInfo, getMessageId, getMessageTimestamp, isMediaMessage, verifyWebhookSignature };

package/dist/index.js

@@ -230,6 +230,7 @@ var WABAClient = class {
 };
 
 // src/api/client.ts
+var import_node_fs = require("fs");
 var DEFAULT_API_VERSION2 = "v22.0";
 var DEFAULT_BASE_URL2 = "https://graph.facebook.com";
 var WABAApiClient = class {
@@ -364,6 +365,263 @@ var WABAApiClient = class {
     const url = `${this.baseUrl}/${this.apiVersion}/${this.phoneNumberId}/messages`;
     return this.makeRequest(url, "POST", payload);
   }
+  /**
+   * Create a new WhatsApp Flow.
+   *
+   * @param wabaId - WhatsApp Business Account ID
+   * @param options - Flow creation options
+   * @throws {WABAAuthError} - Authentication failure (invalid token)
+   * @throws {WABASendError} - Flow creation failure
+   * @throws {WABANetworkError} - Network/connection failures
+   */
+  async createFlow(wabaId, options) {
+    const url = `${this.baseUrl}/${this.apiVersion}/${wabaId}/flows`;
+    const formData = new FormData();
+    formData.append("name", options.name);
+    const categories = options.categories ?? ["OTHER"];
+    formData.append("categories", JSON.stringify(categories));
+    if (options.endpointUri) {
+      formData.append("endpoint_uri", options.endpointUri);
+    }
+    if (options.cloneFlowId) {
+      formData.append("clone_flow_id", options.cloneFlowId);
+    }
+    return this.makeFormDataRequest(url, formData);
+  }
+  /**
+   * Upload or update Flow JSON for an existing flow.
+   *
+   * @param flowId - Flow ID to update
+   * @param filePath - Path to the Flow JSON file
+   * @throws {WABAAuthError} - Authentication failure (invalid token)
+   * @throws {WABASendError} - Flow update failure
+   * @throws {WABANetworkError} - Network/connection failures
+   */
+  async updateFlowJson(flowId, filePath) {
+    const url = `${this.baseUrl}/${this.apiVersion}/${flowId}/assets`;
+    const fileContent = (0, import_node_fs.readFileSync)(filePath, "utf8");
+    const blob = new Blob([fileContent], { type: "application/json" });
+    const formData = new FormData();
+    formData.append("file", blob, "flow.json");
+    formData.append("name", "flow.json");
+    formData.append("asset_type", "FLOW_JSON");
+    return this.makeFormDataRequest(url, formData);
+  }
+  /**
+   * Publish a flow. This action is irreversible.
+   * Once published, the flow and its assets become immutable.
+   * To update a published flow, create a new flow with clone_flow_id.
+   *
+   * @param flowId - Flow ID to publish
+   * @throws {WABAAuthError} - Authentication failure (invalid token)
+   * @throws {WABASendError} - Flow publish failure
+   * @throws {WABANetworkError} - Network/connection failures
+   */
+  async publishFlow(flowId) {
+    const url = `${this.baseUrl}/${this.apiVersion}/${flowId}/publish`;
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.accessToken}`
+        }
+      });
+    } catch (error) {
+      throw new WABANetworkError(
+        `Failed to make request: ${error instanceof Error ? error.message : "Unknown error"}`,
+        error instanceof Error ? error : void 0
+      );
+    }
+    if (response.ok) {
+      return await response.json();
+    }
+    const errorBody = await response.json().catch(() => null);
+    if (response.status === 401 || response.status === 403) {
+      throw new WABAAuthError(
+        `Authentication failed: ${response.status} ${response.statusText}`,
+        response.status
+      );
+    }
+    throw new WABASendError(
+      `Request failed: ${response.status} ${response.statusText}`,
+      response.status,
+      errorBody
+    );
+  }
+  /**
+   * List all flows for a WhatsApp Business Account.
+   *
+   * @param wabaId - WhatsApp Business Account ID
+   * @throws {WABAAuthError} - Authentication failure (invalid token)
+   * @throws {WABASendError} - Request failure
+   * @throws {WABANetworkError} - Network/connection failures
+   */
+  async listFlows(wabaId) {
+    const url = `${this.baseUrl}/${this.apiVersion}/${wabaId}/flows`;
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "GET",
+        headers: {
+          Authorization: `Bearer ${this.accessToken}`
+        }
+      });
+    } catch (error) {
+      throw new WABANetworkError(
+        `Failed to make request: ${error instanceof Error ? error.message : "Unknown error"}`,
+        error instanceof Error ? error : void 0
+      );
+    }
+    if (response.ok) {
+      return await response.json();
+    }
+    const errorBody = await response.json().catch(() => null);
+    if (response.status === 401 || response.status === 403) {
+      throw new WABAAuthError(
+        `Authentication failed: ${response.status} ${response.statusText}`,
+        response.status
+      );
+    }
+    throw new WABASendError(
+      `Request failed: ${response.status} ${response.statusText}`,
+      response.status,
+      errorBody
+    );
+  }
+  /**
+   * List all message templates for a WhatsApp Business Account.
+   *
+   * @param wabaId - WhatsApp Business Account ID
+   * @throws {WABAAuthError} - Authentication failure (invalid token)
+   * @throws {WABASendError} - Request failure
+   * @throws {WABANetworkError} - Network/connection failures
+   */
+  async listTemplates(wabaId) {
+    const url = `${this.baseUrl}/${this.apiVersion}/${wabaId}/message_templates`;
+    return this.makeGetRequest(url);
+  }
+  /**
+   * Create a new message template.
+   *
+   * @param wabaId - WhatsApp Business Account ID
+   * @param request - Template creation request
+   * @throws {WABAAuthError} - Authentication failure (invalid token)
+   * @throws {WABASendError} - Template creation failure
+   * @throws {WABANetworkError} - Network/connection failures
+   */
+  async createTemplate(wabaId, request) {
+    const url = `${this.baseUrl}/${this.apiVersion}/${wabaId}/message_templates`;
+    return this.makeRequest(url, "POST", request);
+  }
+  /**
+   * Delete a message template by name.
+   *
+   * @param wabaId - WhatsApp Business Account ID
+   * @param templateName - Name of the template to delete
+   * @throws {WABAAuthError} - Authentication failure (invalid token)
+   * @throws {WABASendError} - Template deletion failure
+   * @throws {WABANetworkError} - Network/connection failures
+   */
+  async deleteTemplate(wabaId, templateName) {
+    const url = `${this.baseUrl}/${this.apiVersion}/${wabaId}/message_templates?name=${encodeURIComponent(templateName)}`;
+    return this.makeDeleteRequest(url);
+  }
+  async makeGetRequest(url) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "GET",
+        headers: {
+          Authorization: `Bearer ${this.accessToken}`
+        }
+      });
+    } catch (error) {
+      throw new WABANetworkError(
+        `Failed to make request: ${error instanceof Error ? error.message : "Unknown error"}`,
+        error instanceof Error ? error : void 0
+      );
+    }
+    if (response.ok) {
+      return await response.json();
+    }
+    const errorBody = await response.json().catch(() => null);
+    if (response.status === 401 || response.status === 403) {
+      throw new WABAAuthError(
+        `Authentication failed: ${response.status} ${response.statusText}`,
+        response.status
+      );
+    }
+    throw new WABASendError(
+      `Request failed: ${response.status} ${response.statusText}`,
+      response.status,
+      errorBody
+    );
+  }
+  async makeDeleteRequest(url) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "DELETE",
+        headers: {
+          Authorization: `Bearer ${this.accessToken}`
+        }
+      });
+    } catch (error) {
+      throw new WABANetworkError(
+        `Failed to make request: ${error instanceof Error ? error.message : "Unknown error"}`,
+        error instanceof Error ? error : void 0
+      );
+    }
+    if (response.ok) {
+      return await response.json();
+    }
+    const errorBody = await response.json().catch(() => null);
+    if (response.status === 401 || response.status === 403) {
+      throw new WABAAuthError(
+        `Authentication failed: ${response.status} ${response.statusText}`,
+        response.status
+      );
+    }
+    throw new WABASendError(
+      `Request failed: ${response.status} ${response.statusText}`,
+      response.status,
+      errorBody
+    );
+  }
+  async makeFormDataRequest(url, formData) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.accessToken}`
+          // Note: Do NOT set Content-Type header - fetch will set it with boundary for FormData
+        },
+        body: formData
+      });
+    } catch (error) {
+      throw new WABANetworkError(
+        `Failed to make request: ${error instanceof Error ? error.message : "Unknown error"}`,
+        error instanceof Error ? error : void 0
+      );
+    }
+    if (response.ok) {
+      return await response.json();
+    }
+    const errorBody = await response.json().catch(() => null);
+    if (response.status === 401 || response.status === 403) {
+      throw new WABAAuthError(
+        `Authentication failed: ${response.status} ${response.statusText}`,
+        response.status
+      );
+    }
+    throw new WABASendError(
+      `Request failed: ${response.status} ${response.statusText}`,
+      response.status,
+      errorBody
+    );
+  }
   async makeRequest(url, method, body) {
     let response;
     try {