waba-toolkit 0.3.1 → 0.4.0

package/dist/index.cli.js

@@ -25,7 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/cli/index.ts
 var import_commander = require("commander");
-var import_node_fs3 = require("fs");
+var import_node_fs5 = require("fs");
 var import_node_path2 = require("path");
 
 // src/cli/commands/configure.ts
@@ -373,6 +373,7 @@ Valid fields: ${validFields.join(", ")}`
 }
 
 // src/api/client.ts
+var import_node_fs2 = require("fs");
 var DEFAULT_API_VERSION = "v22.0";
 var DEFAULT_BASE_URL = "https://graph.facebook.com";
 var WABAApiClient = class {
@@ -507,6 +508,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_fs2.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 {
@@ -587,7 +845,7 @@ async function deregisterPhone(options) {
 }
 
 // src/cli/commands/send.ts
-var import_node_fs2 = require("fs");
+var import_node_fs3 = require("fs");
 async function sendText(options) {
   try {
     const accessToken = resolveAccessToken();
@@ -620,7 +878,7 @@ async function sendTemplate(options) {
     const config = getConfig();
     let templateData;
     try {
-      const fileContent = (0, import_node_fs2.readFileSync)(options.file, "utf8");
+      const fileContent = (0, import_node_fs3.readFileSync)(options.file, "utf8");
       templateData = JSON.parse(fileContent);
     } catch (error) {
       throw new Error(
@@ -650,7 +908,7 @@ async function sendFile(options) {
     const config = getConfig();
     let payload;
     try {
-      const fileContent = (0, import_node_fs2.readFileSync)(options.payload, "utf8");
+      const fileContent = (0, import_node_fs3.readFileSync)(options.payload, "utf8");
       payload = JSON.parse(fileContent);
     } catch (error) {
       throw new Error(
@@ -698,9 +956,183 @@ async function listPhones(options) {
   }
 }
 
+// src/cli/commands/flow.ts
+async function listFlows(options) {
+  try {
+    const accessToken = resolveAccessToken();
+    const wabaId = resolveWabaId(options.wabaId);
+    const config = getConfig();
+    const client = new WABAApiClient({
+      accessToken,
+      phoneNumberId: "",
+      // Not needed for flow operations
+      apiVersion: config.apiVersion
+    });
+    const response = await client.listFlows(wabaId);
+    printJson(response);
+  } catch (error) {
+    if (error instanceof WABASendError) {
+      console.error(formatError("Failed to list flows", error.errorPayload));
+    } else {
+      handleError(error);
+    }
+    process.exit(1);
+  }
+}
+async function createFlow(options) {
+  try {
+    const accessToken = resolveAccessToken();
+    const wabaId = resolveWabaId(options.wabaId);
+    const config = getConfig();
+    const client = new WABAApiClient({
+      accessToken,
+      phoneNumberId: "",
+      // Not needed for flow operations
+      apiVersion: config.apiVersion
+    });
+    let categories;
+    if (options.categories) {
+      categories = options.categories.split(",").map((c) => c.trim());
+    }
+    const response = await client.createFlow(wabaId, {
+      name: options.name,
+      categories,
+      endpointUri: options.endpointUri,
+      cloneFlowId: options.cloneFlowId
+    });
+    printJson(response);
+  } catch (error) {
+    if (error instanceof WABASendError) {
+      console.error(formatError("Failed to create flow", error.errorPayload));
+    } else {
+      handleError(error);
+    }
+    process.exit(1);
+  }
+}
+async function updateFlow(options) {
+  try {
+    const accessToken = resolveAccessToken();
+    const config = getConfig();
+    const client = new WABAApiClient({
+      accessToken,
+      phoneNumberId: "",
+      // Not needed for flow operations
+      apiVersion: config.apiVersion
+    });
+    const response = await client.updateFlowJson(options.flowId, options.file);
+    printJson(response);
+  } catch (error) {
+    if (error instanceof WABASendError) {
+      console.error(formatError("Failed to update flow", error.errorPayload));
+    } else {
+      handleError(error);
+    }
+    process.exit(1);
+  }
+}
+async function publishFlow(options) {
+  try {
+    const accessToken = resolveAccessToken();
+    const config = getConfig();
+    const client = new WABAApiClient({
+      accessToken,
+      phoneNumberId: "",
+      // Not needed for flow operations
+      apiVersion: config.apiVersion
+    });
+    const response = await client.publishFlow(options.flowId);
+    printJson(response);
+  } catch (error) {
+    if (error instanceof WABASendError) {
+      console.error(formatError("Failed to publish flow", error.errorPayload));
+    } else {
+      handleError(error);
+    }
+    process.exit(1);
+  }
+}
+
+// src/cli/commands/template.ts
+var import_node_fs4 = require("fs");
+async function listTemplates(options) {
+  try {
+    const accessToken = resolveAccessToken();
+    const wabaId = resolveWabaId(options.wabaId);
+    const config = getConfig();
+    const client = new WABAApiClient({
+      accessToken,
+      phoneNumberId: "",
+      // Not needed for template operations
+      apiVersion: config.apiVersion
+    });
+    const response = await client.listTemplates(wabaId);
+    printJson(response);
+  } catch (error) {
+    if (error instanceof WABASendError) {
+      console.error(formatError("Failed to list templates", error.errorPayload));
+    } else {
+      handleError(error);
+    }
+    process.exit(1);
+  }
+}
+async function createTemplate(options) {
+  try {
+    const accessToken = resolveAccessToken();
+    const wabaId = resolveWabaId(options.wabaId);
+    const config = getConfig();
+    const client = new WABAApiClient({
+      accessToken,
+      phoneNumberId: "",
+      // Not needed for template operations
+      apiVersion: config.apiVersion
+    });
+    const fileContent = (0, import_node_fs4.readFileSync)(options.file, "utf8");
+    const templateData = JSON.parse(fileContent);
+    const request = {
+      name: options.name,
+      ...templateData
+    };
+    const response = await client.createTemplate(wabaId, request);
+    printJson(response);
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      console.error(formatError("Invalid JSON in template file", { message: error.message }));
+    } else if (error instanceof WABASendError) {
+      console.error(formatError("Failed to create template", error.errorPayload));
+    } else {
+      handleError(error);
+    }
+    process.exit(1);
+  }
+}
+async function deleteTemplate(options) {
+  try {
+    const accessToken = resolveAccessToken();
+    const wabaId = resolveWabaId(options.wabaId);
+    const config = getConfig();
+    const client = new WABAApiClient({
+      accessToken,
+      phoneNumberId: "",
+      // Not needed for template operations
+      apiVersion: config.apiVersion
+    });
+    const response = await client.deleteTemplate(wabaId, options.name);
+    printJson(response);
+  } catch (error) {
+    if (error instanceof WABASendError) {
+      console.error(formatError("Failed to delete template", error.errorPayload));
+    } else {
+      handleError(error);
+    }
+    process.exit(1);
+  }
+}
+
 // src/cli/index.ts
 var packageJson = JSON.parse(
-  (0, import_node_fs3.readFileSync)((0, import_node_path2.join)(__dirname, "../package.json"), "utf8")
+  (0, import_node_fs5.readFileSync)((0, import_node_path2.join)(__dirname, "../package.json"), "utf8")
 );
 var program = new import_commander.Command();
 program.name("waba-toolkit").description("WhatsApp Business API Toolkit - CLI for webhooks, media, and messaging").version(packageJson.version).addHelpText("after", `
@@ -710,6 +1142,13 @@ Examples:
   $ waba-toolkit list-phones --waba-id 123    # List phone numbers
   $ waba-toolkit send text --to 1234567890 --message "Hello"
   $ waba-toolkit register --pin 123456
+  $ waba-toolkit list-flows --waba-id 123     # List all flows
+  $ waba-toolkit create flow --name "My Flow" # Create a new WhatsApp Flow
+  $ waba-toolkit update flow --flow-id 123 --file flow.json  # Upload Flow JSON
+  $ waba-toolkit publish flow --flow-id 123   # Publish flow (irreversible)
+  $ waba-toolkit list-templates --waba-id 123 # List all templates
+  $ waba-toolkit create template --name my_tpl --file template.json
+  $ waba-toolkit delete template --name old_tpl
 
 Environment Variables:
   WABA_TOOLKIT_ACCESS_TOKEN       Access token for WhatsApp API
@@ -745,14 +1184,16 @@ configCommand.command("set <field> <value>").description("Update specific config
 Examples:
   $ waba-toolkit config set access-token EAABsbCS...
   $ waba-toolkit config set waba-id 1234567890
+  $ waba-toolkit config set default-phone-number-id 9876543210
   $ waba-toolkit config set api-version v22.0
+  $ waba-toolkit config set business-id 1122334455
 
 Valid fields:
-  - access-token
-  - default-phone-number-id
-  - api-version
-  - waba-id
-  - business-id
+  access-token              Your Meta access token (required for API calls)
+  default-phone-number-id   Default phone number ID for sending messages
+  waba-id                   WhatsApp Business Account ID (for flows/templates)
+  api-version               Graph API version (default: v22.0)
+  business-id               Meta Business Portfolio ID
 `).action(setConfigField);
 program.command("register").description("Register phone number with WhatsApp Business API").option("--bpid <phone-number-id>", "Phone number ID (overrides default)").option("--phone-number-id <id>", "Phone number ID (alias for --bpid)").requiredOption("--pin <pin>", "Six-digit PIN for registration").addHelpText("after", `
 Examples:
@@ -860,4 +1301,114 @@ Payload JSON format (image message):
     payload: options.payload
   });
 });
+program.command("list-flows").description("List all WhatsApp Flows for a WABA").option("--waba-id <id>", "WhatsApp Business Account ID (overrides default)").addHelpText("after", `
+Examples:
+  $ waba-toolkit list-flows --waba-id 1234567890
+  $ WABA_TOOLKIT_WABA_ID=1234567890 waba-toolkit list-flows
+
+Output:
+  Returns JSON with flow details including name, status, categories, and validation errors.
+`).action(async (options) => {
+  await listFlows({
+    wabaId: options.wabaId
+  });
+});
+var createCommand = program.command("create").description("Create WhatsApp Business API resources");
+createCommand.command("flow").description("Create a new WhatsApp Flow").requiredOption("--name <name>", "Name of the flow").option("--categories <categories>", "Comma-separated list of categories (default: OTHER)").option("--endpoint-uri <uri>", "Endpoint URI for the flow").option("--clone-flow-id <id>", "Clone from existing flow ID").option("--waba-id <id>", "WhatsApp Business Account ID (overrides default)").addHelpText("after", `
+Examples:
+  $ waba-toolkit create flow --name "My Flow"
+  $ waba-toolkit create flow --name "Lead Gen Flow" --categories LEAD_GENERATION
+  $ waba-toolkit create flow --name "Multi-Category" --categories LEAD_GENERATION,SURVEY
+  $ waba-toolkit create flow --name "Clone" --clone-flow-id 123456789
+
+Categories:
+  SIGN_UP, SIGN_IN, APPOINTMENT_BOOKING, LEAD_GENERATION,
+  CONTACT_US, CUSTOMER_SUPPORT, SURVEY, OTHER
+`).action(async (options) => {
+  await createFlow({
+    name: options.name,
+    categories: options.categories,
+    endpointUri: options.endpointUri,
+    cloneFlowId: options.cloneFlowId,
+    wabaId: options.wabaId
+  });
+});
+var updateCommand = program.command("update").description("Update WhatsApp Business API resources");
+updateCommand.command("flow").description("Upload or update Flow JSON for an existing flow").requiredOption("--flow-id <id>", "Flow ID to update").requiredOption("--file <path>", "Path to the Flow JSON file").addHelpText("after", `
+Examples:
+  $ waba-toolkit update flow --flow-id 123456789 --file ./my-flow.json
+
+Output:
+  Returns JSON with success status and any validation errors from the Flow JSON.
+  Validation errors include line/column numbers to help locate issues.
+`).action(async (options) => {
+  await updateFlow({
+    flowId: options.flowId,
+    file: options.file
+  });
+});
+var publishCommand = program.command("publish").description("Publish WhatsApp Business API resources");
+publishCommand.command("flow").description("Publish a flow (irreversible)").requiredOption("--flow-id <id>", "Flow ID to publish").addHelpText("after", `
+Examples:
+  $ waba-toolkit publish flow --flow-id 123456789
+
+WARNING: Publishing a flow is IRREVERSIBLE.
+Once published, the flow and its assets become immutable.
+To update a published flow, create a new flow with --clone-flow-id.
+`).action(async (options) => {
+  await publishFlow({
+    flowId: options.flowId
+  });
+});
+program.command("list-templates").description("List all message templates for a WABA").option("--waba-id <id>", "WhatsApp Business Account ID (overrides default)").addHelpText("after", `
+Examples:
+  $ waba-toolkit list-templates --waba-id 1234567890
+  $ WABA_TOOLKIT_WABA_ID=1234567890 waba-toolkit list-templates
+
+Output:
+  Returns JSON with template details including name, status, category, and components.
+`).action(async (options) => {
+  await listTemplates({
+    wabaId: options.wabaId
+  });
+});
+createCommand.command("template").description("Create a new message template").requiredOption("--name <name>", "Template name (lowercase, underscores, no spaces)").requiredOption("--file <path>", "Path to template JSON file").option("--waba-id <id>", "WhatsApp Business Account ID (overrides default)").addHelpText("after", `
+Examples:
+  $ waba-toolkit create template --name my_template --file ./template.json
+  $ waba-toolkit create template --name order_update --file ./order-template.json --waba-id 123
+
+Template JSON format:
+  {
+    "language": "en_US",
+    "category": "MARKETING",
+    "components": [
+      {
+        "type": "BODY",
+        "text": "Hello {{1}}, your order {{2}} is ready!"
+      }
+    ]
+  }
+
+Categories:
+  AUTHENTICATION, MARKETING, UTILITY
+`).action(async (options) => {
+  await createTemplate({
+    name: options.name,
+    file: options.file,
+    wabaId: options.wabaId
+  });
+});
+var deleteCommand = program.command("delete").description("Delete WhatsApp Business API resources");
+deleteCommand.command("template").description("Delete a message template by name").requiredOption("--name <name>", "Template name to delete").option("--waba-id <id>", "WhatsApp Business Account ID (overrides default)").addHelpText("after", `
+Examples:
+  $ waba-toolkit delete template --name my_template
+  $ waba-toolkit delete template --name old_promo --waba-id 1234567890
+
+Note: Deleting a template removes all language versions of that template.
+`).action(async (options) => {
+  await deleteTemplate({
+    name: options.name,
+    wabaId: options.wabaId
+  });
+});
 program.parse();