whatsapp-cloud 0.0.3 → 0.0.4

package/src/services/messages/methods/send-text.ts

@@ -0,0 +1,32 @@
+import type { MessagesClient } from "../MessagesClient";
+import { sendTextRequestSchema } from "../../../schemas/messages/request";
+import type { SendTextRequest } from "../../../types/messages/request";
+import type { MessageResponse } from "../../../types/messages/response";
+import { buildMessagePayload } from "../utils/build-message-payload";
+import { transformZodError } from "../../../utils/zod-error";
+
+/**
+ * Send a text message
+ *
+ * @param messagesClient - Messages client with phone number ID baked in
+ * @param request - Text message request (to, text)
+ */
+export async function sendText(
+  messagesClient: MessagesClient,
+  request: SendTextRequest
+): Promise<MessageResponse> {
+  // Validate request with schema - throws WhatsAppValidationError if invalid
+  const result = sendTextRequestSchema.safeParse(request);
+  if (!result.success) {
+    throw transformZodError(result.error);
+  }
+  const data = result.data;
+
+  // Build message payload using common structure
+  const payload = buildMessagePayload(data.to, "text", {
+    text: data.text,
+  });
+
+  // Make API request - messagesClient handles the phoneNumberId prefix automatically
+  return messagesClient.post<MessageResponse>("/messages", payload);
+}

package/src/services/messages/utils/build-message-payload.ts

@@ -0,0 +1,32 @@
+/**
+ * Builds the base message payload structure that's common to all WhatsApp messages
+ *
+ * According to WhatsApp API docs, all messages follow this structure:
+ * {
+ *   "messaging_product": "whatsapp",
+ *   "recipient_type": "individual",
+ *   "to": "<WHATSAPP_USER_PHONE_NUMBER>",
+ *   "type": "<MESSAGE_TYPE>",
+ *   "<MESSAGE_TYPE>": {<MESSAGE_CONTENTS>}
+ * }
+ *
+ * Note: undefined values in content are automatically omitted by JSON.stringify
+ *
+ * @param to - WhatsApp phone number (E.164 format)
+ * @param type - Message type (text, image, video, etc.)
+ * @param content - Message-specific content object
+ * @returns Complete message payload ready for API request
+ */
+export function buildMessagePayload<T extends Record<string, unknown>>(
+  to: string,
+  type: string,
+  content: T
+) {
+  return {
+    messaging_product: "whatsapp" as const,
+    recipient_type: "individual" as const,
+    to,
+    type,
+    ...content,
+  };
+}

package/src/types/accounts/index.ts

@@ -0,0 +1 @@
+export type * from "./phone-number";

package/src/types/accounts/phone-number.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { phoneNumberListResponseSchema } from "../../schemas/accounts/phone-number";
+
+/**
+ * Type for phone number list response
+ */
+export type PhoneNumberListResponse = z.infer<
+  typeof phoneNumberListResponseSchema
+>;

package/src/types/business/account.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import { businessAccountsListResponseSchema } from "../../schemas/business/account";
+
+/**
+ * Type for WhatsApp Business Accounts list response
+ */
+export type BusinessAccountsListResponse = z.infer<
+  typeof businessAccountsListResponseSchema
+>;
+

package/src/types/business/index.ts

@@ -0,0 +1,2 @@
+export type * from "./account";
+

package/src/types/client.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import { clientConfigSchema } from "../schemas/client";
+
+/**
+ * Client configuration type
+ */
+export type ClientConfig = z.infer<typeof clientConfigSchema>;
+

package/src/types/debug.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import { debugTokenResponseSchema } from "../schemas/debug";
+
+/**
+ * Type for debug token response
+ */
+export type DebugTokenResponse = z.infer<typeof debugTokenResponseSchema>;
+

package/src/types/index.ts

@@ -0,0 +1,5 @@
+export type * from "./client";
+export type * from "./messages/index";
+export type * from "./accounts/index";
+export type * from "./business/index";
+export type * from "./debug";

package/src/types/messages/index.ts

@@ -0,0 +1,2 @@
+export type * from "./request";
+export type * from "./response";

package/src/types/messages/request.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import {
+  sendTextRequestSchema,
+  sendImageRequestSchema,
+  sendLocationRequestSchema,
+  sendReactionRequestSchema,
+} from "../../schemas/messages/request";
+
+/**
+ * Type for sending a text message
+ */
+export type SendTextRequest = z.infer<typeof sendTextRequestSchema>;
+
+/**
+ * Type for sending an image message
+ */
+export type SendImageRequest = z.infer<typeof sendImageRequestSchema>;
+
+/**
+ * Type for sending a location message
+ */
+export type SendLocationRequest = z.infer<typeof sendLocationRequestSchema>;
+
+/**
+ * Type for sending a reaction message
+ */
+export type SendReactionRequest = z.infer<typeof sendReactionRequestSchema>;

package/src/types/messages/response.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import { messageResponseSchema } from "../../schemas/messages/response";
+
+/**
+ * Type for message response
+ */
+export type MessageResponse = z.infer<typeof messageResponseSchema>;

package/src/utils/zod-error.ts

@@ -0,0 +1,28 @@
+import { ZodError } from "zod";
+import { WhatsAppValidationError } from "../errors";
+
+/**
+ * Transform a ZodError into a WhatsAppValidationError
+ *
+ * Uses the first error's message (Zod already orders errors by importance)
+ * Can be used for any validation: config, requests, responses, etc.
+ */
+export function transformZodError(error: ZodError): WhatsAppValidationError {
+  const issues = error.issues.map((err) => ({
+    path: err.path as readonly (string | number)[],
+    message: err.message,
+  }));
+
+  // Use the first error as the main message (Zod orders by importance)
+  const firstError = error.issues[0];
+  if (firstError) {
+    return new WhatsAppValidationError(
+      firstError.message,
+      typeof firstError.path[0] === "string" ? firstError.path[0] : undefined,
+      issues
+    );
+  }
+
+  // Fallback (shouldn't happen)
+  return new WhatsAppValidationError("Validation failed", undefined, issues);
+}

package/tsconfig.json

@@ -1,5 +1,7 @@
 {
   // Visit https://aka.ms/tsconfig to read more about this file
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "examples"],
   "compilerOptions": {
     // File Layout
     "rootDir": "./src",
@@ -7,7 +9,8 @@
 
     // Environment Settings
     // See also https://aka.ms/tsconfig/module
-    "module": "nodenext",
+    "module": "esnext",
+    "moduleResolution": "bundler",
     "target": "esnext",
     "types": [],
     // For nodejs: