meta-cloud-api 1.4.0 → 1.6.0

package/README.md

@@ -211,21 +211,81 @@ export default async function handler(req: NextApiRequest, res: NextApiResponse)
 import { MessageTypesEnum } from 'meta-cloud-api';
 
 // Pre-process all messages (e.g., mark as read)
-bot.processor.onMessagePreProcess(async (whatsapp, message) => {
-  await whatsapp.messages.markAsRead({ messageId: message.id });
+// ✨ Use processed.messageId for consistent ID access across all message types
+bot.processor.onMessagePreProcess(async (whatsapp, processed) => {
+  // messageId is automatically extracted from the correct location
+  // (message.id for most types, message.context.id for nfm_reply)
+  await whatsapp.messages.markAsRead({ messageId: processed.messageId });
 });
 
-// Handle different message types
-bot.processor.onMessage(MessageTypesEnum.Text, async (whatsapp, message) => {
-  // Handle text messages
+// ✨ Type-safe specialized handlers (recommended)
+// These methods provide better type safety - no need for optional chaining!
+
+bot.processor.onText(async (whatsapp, processed) => {
+  const { message, messageId } = processed;
+  // message.text is guaranteed to exist - no need for message.text?.body
+  console.log('Received:', message.text.body);
+  await whatsapp.messages.text({
+    to: message.from,
+    text: { body: `Echo: ${message.text.body}` }
+  });
+
+  // Mark as read using the extracted messageId
+  await whatsapp.messages.markAsRead({ messageId });
 });
 
-bot.processor.onMessage(MessageTypesEnum.Image, async (whatsapp, message) => {
-  // Handle image messages
+bot.processor.onImage(async (whatsapp, processed) => {
+  const { message } = processed;
+  // message.image is guaranteed to exist
+  console.log('Image ID:', message.image.id);
+  console.log('Caption:', message.image.caption);
 });
 
-bot.processor.onMessage(MessageTypesEnum.Document, async (whatsapp, message) => {
-  // Handle document messages
+bot.processor.onInteractive(async (whatsapp, processed) => {
+  const { message, messageId } = processed;
+  // message.interactive is guaranteed to exist
+  if (message.interactive.type === 'nfm_reply') {
+    const flowResponse = JSON.parse(message.interactive.nfm_reply.response_json);
+    console.log('Flow response:', flowResponse);
+
+    // messageId works correctly for nfm_reply (uses context.id automatically)
+    await whatsapp.messages.markAsRead({ messageId });
+  } else if (message.interactive.type === 'button_reply') {
+    console.log('Button clicked:', message.interactive.button_reply.id);
+  } else if (message.interactive.type === 'list_reply') {
+    console.log('List item selected:', message.interactive.list_reply.id);
+  }
+});
+
+// Other specialized handlers available:
+// onVideo, onAudio, onDocument, onSticker, onButton,
+// onLocation, onContacts, onReaction, onOrder, onSystem
+
+// 📝 Legacy generic handler (still supported)
+bot.processor.onMessage(MessageTypesEnum.Text, async (whatsapp, processed) => {
+  // With generic handler, you need optional chaining
+  console.log(processed.message.text?.body); // ⚠️ Need ? because text might be undefined
+
+  // But messageId is always available regardless of message type!
+  await whatsapp.messages.markAsRead({ messageId: processed.messageId });
+});
+
+// 🔍 TypeScript Discriminated Union for Manual Type Narrowing
+// Use this when you need to check message types dynamically in pre/post-process handlers
+bot.processor.onMessagePreProcess(async (whatsapp, processed) => {
+  const { message, messageId } = processed;
+
+  // TypeScript automatically narrows the type based on the type property!
+  if (message.type === MessageTypesEnum.Text) {
+    console.log(message.text.body); // ✅ No optional chaining needed!
+  } else if (message.type === MessageTypesEnum.Image) {
+    console.log(message.image.id); // ✅ Type-safe!
+  } else if (message.type === MessageTypesEnum.Interactive) {
+    console.log(message.interactive.type); // ✅ Guaranteed to exist!
+  }
+
+  // messageId works for all types - automatically extracted from the correct location
+  await whatsapp.messages.markAsRead({ messageId });
 });
 
 // Handle message status updates