@zapyapi/sdk 1.0.0-beta.13 → 1.0.0-beta.15

package/index.cjs

@@ -3,7 +3,7 @@
 var axios = require('axios');
 
 /** SDK version - auto-generated from package.json */
-const SDK_VERSION = '1.0.0-beta.13';
+const SDK_VERSION = '1.0.0-beta.15';
 
 /**
  * Custom error classes for @zapyapi/sdk
@@ -1496,19 +1496,53 @@ const ZapyEventTypes = {
  * Phone number utilities for @zapyapi/sdk
  */
 /**
- * Normalize a phone number to the format expected by the API
+ * UUID v4 regex pattern for detecting Zapy contact IDs
+ */
+const UUID_V4_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * Valid WhatsApp ID suffixes
+ */
+const WHATSAPP_ID_SUFFIXES = ['@s.whatsapp.net', '@c.us', '@g.us', '@lid'];
+/**
+ * Check if a string is a valid WhatsApp ID (JID/LID)
+ */
+function isWhatsAppId(value) {
+  return WHATSAPP_ID_SUFFIXES.some(suffix => value.endsWith(suffix));
+}
+/**
+ * Normalize a phone number or WhatsApp identifier to the format expected by the API
+ *
+ * Accepts:
+ * - Phone numbers (with or without country code)
+ * - Zapy contact UUIDs
+ * - WhatsApp JIDs (e.g., 5511999999999@s.whatsapp.net)
+ * - WhatsApp LIDs (e.g., 932757054219706064@lid)
+ * - WhatsApp group IDs (e.g., 120363404090439360@g.us)
+ * - Legacy format (e.g., 5511999999999@c.us)
  *
- * @param phone - Phone number in various formats
- * @returns Normalized phone number
+ * @param phone - Phone number or WhatsApp identifier in various formats
+ * @returns Normalized identifier ready for the API
  *
  * @example
- * normalizePhone('11999999999')     // '5511999999999'
- * normalizePhone('5511999999999')   // '5511999999999'
- * normalizePhone('+5511999999999')  // '5511999999999'
- * normalizePhone('5511999999999@s.whatsapp.net') // '5511999999999@s.whatsapp.net'
+ * normalizePhone('11999999999')                          // '5511999999999'
+ * normalizePhone('5511999999999')                        // '5511999999999'
+ * normalizePhone('+5511999999999')                       // '5511999999999'
+ * normalizePhone('5511999999999@s.whatsapp.net')         // '5511999999999@s.whatsapp.net'
+ * normalizePhone('932757054219706064@lid')               // '932757054219706064@lid'
+ * normalizePhone('120363404090439360@g.us')              // '120363404090439360@g.us'
+ * normalizePhone('5f2528b2-93f5-4b90-883a-c423dafc25b1') // '5f2528b2-93f5-4b90-883a-c423dafc25b1'
  */
 function normalizePhone(phone) {
-  // If it's already a WhatsApp ID, return as-is
+  // If it's a UUID (Zapy contact ID), return as-is
+  if (UUID_V4_REGEX.test(phone)) {
+    return phone;
+  }
+  // If it's already a valid WhatsApp ID (JID/LID/group), return as-is
+  if (isWhatsAppId(phone)) {
+    return phone;
+  }
+  // If it contains @ but isn't a valid WhatsApp ID, still pass through
+  // (let the server validate and provide a proper error message)
   if (phone.includes('@')) {
     return phone;
   }
@@ -1526,15 +1560,23 @@ function normalizePhone(phone) {
   return cleaned;
 }
 /**
- * Validate if a string is a valid phone number format
+ * Validate if a string is a valid phone number or WhatsApp identifier
  *
- * @param phone - Phone number to validate
- * @returns Whether the phone number is valid
+ * @param phone - Phone number or WhatsApp identifier to validate
+ * @returns Whether the input is valid
  */
 function isValidPhone(phone) {
-  // WhatsApp IDs are valid
+  // UUIDs (Zapy contact IDs) are valid
+  if (UUID_V4_REGEX.test(phone)) {
+    return true;
+  }
+  // WhatsApp IDs (JID/LID/group) are valid
+  if (isWhatsAppId(phone)) {
+    return true;
+  }
+  // If it contains @ but isn't a valid WhatsApp ID, it's invalid
   if (phone.includes('@')) {
-    return phone.endsWith('@s.whatsapp.net') || phone.endsWith('@c.us') || phone.endsWith('@g.us') || phone.endsWith('@lid');
+    return false;
   }
   // Clean and check if it's a valid number
   const cleaned = phone.replace(/[^\d]/g, '');

package/index.js

@@ -1,7 +1,7 @@
 import axios from 'axios';
 
 /** SDK version - auto-generated from package.json */
-const SDK_VERSION = '1.0.0-beta.13';
+const SDK_VERSION = '1.0.0-beta.15';
 
 /**
  * Custom error classes for @zapyapi/sdk
@@ -1494,19 +1494,53 @@ const ZapyEventTypes = {
  * Phone number utilities for @zapyapi/sdk
  */
 /**
- * Normalize a phone number to the format expected by the API
+ * UUID v4 regex pattern for detecting Zapy contact IDs
+ */
+const UUID_V4_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * Valid WhatsApp ID suffixes
+ */
+const WHATSAPP_ID_SUFFIXES = ['@s.whatsapp.net', '@c.us', '@g.us', '@lid'];
+/**
+ * Check if a string is a valid WhatsApp ID (JID/LID)
+ */
+function isWhatsAppId(value) {
+  return WHATSAPP_ID_SUFFIXES.some(suffix => value.endsWith(suffix));
+}
+/**
+ * Normalize a phone number or WhatsApp identifier to the format expected by the API
+ *
+ * Accepts:
+ * - Phone numbers (with or without country code)
+ * - Zapy contact UUIDs
+ * - WhatsApp JIDs (e.g., 5511999999999@s.whatsapp.net)
+ * - WhatsApp LIDs (e.g., 932757054219706064@lid)
+ * - WhatsApp group IDs (e.g., 120363404090439360@g.us)
+ * - Legacy format (e.g., 5511999999999@c.us)
  *
- * @param phone - Phone number in various formats
- * @returns Normalized phone number
+ * @param phone - Phone number or WhatsApp identifier in various formats
+ * @returns Normalized identifier ready for the API
  *
  * @example
- * normalizePhone('11999999999')     // '5511999999999'
- * normalizePhone('5511999999999')   // '5511999999999'
- * normalizePhone('+5511999999999')  // '5511999999999'
- * normalizePhone('5511999999999@s.whatsapp.net') // '5511999999999@s.whatsapp.net'
+ * normalizePhone('11999999999')                          // '5511999999999'
+ * normalizePhone('5511999999999')                        // '5511999999999'
+ * normalizePhone('+5511999999999')                       // '5511999999999'
+ * normalizePhone('5511999999999@s.whatsapp.net')         // '5511999999999@s.whatsapp.net'
+ * normalizePhone('932757054219706064@lid')               // '932757054219706064@lid'
+ * normalizePhone('120363404090439360@g.us')              // '120363404090439360@g.us'
+ * normalizePhone('5f2528b2-93f5-4b90-883a-c423dafc25b1') // '5f2528b2-93f5-4b90-883a-c423dafc25b1'
  */
 function normalizePhone(phone) {
-  // If it's already a WhatsApp ID, return as-is
+  // If it's a UUID (Zapy contact ID), return as-is
+  if (UUID_V4_REGEX.test(phone)) {
+    return phone;
+  }
+  // If it's already a valid WhatsApp ID (JID/LID/group), return as-is
+  if (isWhatsAppId(phone)) {
+    return phone;
+  }
+  // If it contains @ but isn't a valid WhatsApp ID, still pass through
+  // (let the server validate and provide a proper error message)
   if (phone.includes('@')) {
     return phone;
   }
@@ -1524,15 +1558,23 @@ function normalizePhone(phone) {
   return cleaned;
 }
 /**
- * Validate if a string is a valid phone number format
+ * Validate if a string is a valid phone number or WhatsApp identifier
  *
- * @param phone - Phone number to validate
- * @returns Whether the phone number is valid
+ * @param phone - Phone number or WhatsApp identifier to validate
+ * @returns Whether the input is valid
  */
 function isValidPhone(phone) {
-  // WhatsApp IDs are valid
+  // UUIDs (Zapy contact IDs) are valid
+  if (UUID_V4_REGEX.test(phone)) {
+    return true;
+  }
+  // WhatsApp IDs (JID/LID/group) are valid
+  if (isWhatsAppId(phone)) {
+    return true;
+  }
+  // If it contains @ but isn't a valid WhatsApp ID, it's invalid
   if (phone.includes('@')) {
-    return phone.endsWith('@s.whatsapp.net') || phone.endsWith('@c.us') || phone.endsWith('@g.us') || phone.endsWith('@lid');
+    return false;
   }
   // Clean and check if it's a valid number
   const cleaned = phone.replace(/[^\d]/g, '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapyapi/sdk",
-  "version": "1.0.0-beta.13",
+  "version": "1.0.0-beta.15",
   "description": "Official TypeScript SDK for ZapyAPI - WhatsApp API",
   "main": "./index.cjs",
   "module": "./index.js",

package/src/utils/phone.d.ts

@@ -2,23 +2,34 @@
  * Phone number utilities for @zapyapi/sdk
  */
 /**
- * Normalize a phone number to the format expected by the API
+ * Normalize a phone number or WhatsApp identifier to the format expected by the API
  *
- * @param phone - Phone number in various formats
- * @returns Normalized phone number
+ * Accepts:
+ * - Phone numbers (with or without country code)
+ * - Zapy contact UUIDs
+ * - WhatsApp JIDs (e.g., 5511999999999@s.whatsapp.net)
+ * - WhatsApp LIDs (e.g., 932757054219706064@lid)
+ * - WhatsApp group IDs (e.g., 120363404090439360@g.us)
+ * - Legacy format (e.g., 5511999999999@c.us)
+ *
+ * @param phone - Phone number or WhatsApp identifier in various formats
+ * @returns Normalized identifier ready for the API
  *
  * @example
- * normalizePhone('11999999999')     // '5511999999999'
- * normalizePhone('5511999999999')   // '5511999999999'
- * normalizePhone('+5511999999999')  // '5511999999999'
- * normalizePhone('5511999999999@s.whatsapp.net') // '5511999999999@s.whatsapp.net'
+ * normalizePhone('11999999999')                          // '5511999999999'
+ * normalizePhone('5511999999999')                        // '5511999999999'
+ * normalizePhone('+5511999999999')                       // '5511999999999'
+ * normalizePhone('5511999999999@s.whatsapp.net')         // '5511999999999@s.whatsapp.net'
+ * normalizePhone('932757054219706064@lid')               // '932757054219706064@lid'
+ * normalizePhone('120363404090439360@g.us')              // '120363404090439360@g.us'
+ * normalizePhone('5f2528b2-93f5-4b90-883a-c423dafc25b1') // '5f2528b2-93f5-4b90-883a-c423dafc25b1'
  */
 export declare function normalizePhone(phone: string): string;
 /**
- * Validate if a string is a valid phone number format
+ * Validate if a string is a valid phone number or WhatsApp identifier
  *
- * @param phone - Phone number to validate
- * @returns Whether the phone number is valid
+ * @param phone - Phone number or WhatsApp identifier to validate
+ * @returns Whether the input is valid
  */
 export declare function isValidPhone(phone: string): boolean;
 /**

package/src/utils/phone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../../../../libs/sdk/src/utils/phone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAYnD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhD"}
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../../../../libs/sdk/src/utils/phone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgCpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAsBnD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhD"}

package/src/version.d.ts

@@ -1,3 +1,3 @@
 /** SDK version - auto-generated from package.json */
-export declare const SDK_VERSION = "1.0.0-beta.13";
+export declare const SDK_VERSION = "1.0.0-beta.15";
 //# sourceMappingURL=version.d.ts.map