@wppconnect/wa-js 3.19.0 → 3.19.2

package/CHANGELOG.md

@@ -1,4 +1,9 @@
-# 3.19.0 (2025-11-25)
+## 3.19.2 (2025-11-25)
+
+
+### Bug Fixes
+
+* contact save and remove functions ([#3093](https://github.com/wppconnect-team/wa-js/issues/3093)) ([285c88b](https://github.com/wppconnect-team/wa-js/commit/285c88b3b2feeb21dccb493d5f7301b5f7fa901f))
 
 
 

package/dist/conn/functions/getBuildConstants.d.ts

@@ -13,6 +13,20 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+export interface BuildConstants {
+    VERSION_STR: string;
+    VERSION_BASE: string;
+    VERSION_PRIMARY: string;
+    VERSION_SECONDARY: string;
+    VERSION_TERTIARY: string;
+    WINDOWS_BUILD: string | null;
+    PARSED: {
+        PRIMARY: number;
+        SECONDARY: number;
+        TERTIARY: number;
+    };
+    [key: string]: any;
+}
 /**
  * Get the WhatsApp Web build constants
  * Retrieves the internal WAWebBuildConstants module from WhatsApp source
@@ -25,7 +39,7 @@
  * console.log('Windows Build:', buildConstants.WINDOWS_BUILD);
  * ```
  *
- * @returns {object|null} Object containing version constants or null if not available
+ * @returns {BuildConstants|null} Object containing version constants or null if not available
  * - VERSION_STR: Full version string (e.g., "2.3000.1234567")
  * - VERSION_BASE: Base version (e.g., "2.3000.1234567")
  * - VERSION_PRIMARY: Primary version number
@@ -34,4 +48,19 @@
  * - WINDOWS_BUILD: Windows build number (if applicable)
  * - And other build-related constants
  */
-export declare function getBuildConstants(): string | null;
+export declare function getBuildConstants(): BuildConstants | null;
+/**
+ * Check if the current WhatsApp version is greater than or equal to a specified version
+ *
+ * @example
+ * ```javascript
+ * // Check if version is >= 2.3000.1030110621
+ * if (WPP.conn.isWhatsAppVersionGTE('2.3000.1030110621')) {
+ *   console.log('Using new API');
+ * }
+ * ```
+ *
+ * @param version - Version string to compare against (e.g., "2.3000.1029")
+ * @returns {boolean} True if current version is >= specified version
+ */
+export declare function isWhatsAppVersionGTE(version: string): boolean;

package/dist/conn/functions/index.d.ts

@@ -16,7 +16,7 @@
 export { changeEnviromentDevice } from './changeEnviromentDevice';
 export { genLinkDeviceCodeForPhoneNumber } from './genLinkDeviceCodeForPhoneNumber';
 export { getAuthCode } from './getAuthCode';
-export { getBuildConstants } from './getBuildConstants';
+export { BuildConstants, getBuildConstants, isWhatsAppVersionGTE, } from './getBuildConstants';
 export { getHistorySyncProgress, HistorySyncProgress, } from './getHistorySyncProgress';
 export { getMigrationState, MigrationState } from './getMigrationState';
 export { getMyDeviceId } from './getMyDeviceId';

package/dist/contact/functions/save.d.ts

@@ -21,13 +21,17 @@ import { ContactModel } from '../../whatsapp';
  * ```javascript
  * await WPP.contact.save('5533999999999@c.us', 'John', {
  *   surname: 'Doe',
- *   syncAdressBook: true,
+ *   syncAddressBook: true,
  * });
  * ```
  *
  * @category Contact
  */
-export declare function save(contactId: string | any, name: string, options?: {
+export declare function save(contactId: string | any, firstName: string, options?: {
+    /** @deprecated Use lastName instead */
     surname?: string;
+    /** @deprecated Use syncAddressBook instead, this one with typo was updated */
     syncAdressBook?: boolean;
+    lastName?: string;
+    syncAddressBook?: boolean;
 }): Promise<ContactModel | undefined>;

package/dist/whatsapp/functions/deleteContactAction.d.ts

@@ -13,7 +13,46 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { Wid } from '../misc';
 /**
+ * Deletes a contact from the contact list (legacy API).
+ *
  * @whatsapp WAWebDeleteContactAction >= 2.3000.0
+ * @whatsapp ~2.3000.1030040369
+ *
+ * @param number - Phone number string
+ *
+ * @deprecated Since around WhatsApp version 2.3000.1030110621. Use the new object-based API instead.
+ *             Use `deleteContactActionV2({ phoneNumber: wid })` for regular contacts
+ *             or `deleteContactActionV2({ username, lid })` for username contacts.
+ *
+ * @example
+ * // Deprecated usage
+ * await deleteContactAction('5511999999999');
+ *
+ * // Use this instead
+ * await deleteContactActionV2({ phoneNumber: wid });
  */
 export declare function deleteContactAction(number: string): Promise<void>;
+/**
+ * Deletes a contact from the contact list.
+ *
+ * @whatsapp WAWebDeleteContactAction >= 2.3000.1030110621
+ *
+ * @param params - Object with contact identifiers
+ * @param params.phoneNumber - Contact phone number as Wid (for regular contacts)
+ * @param params.username - Contact username (for username contacts)
+ * @param params.lid - Contact LID (for username contacts)
+ *
+ * @example
+ * // Delete regular contact by phone number
+ * await deleteContactActionV2({ phoneNumber: wid });
+ *
+ * // Delete username contact
+ * await deleteContactActionV2({ username: 'john', lid: '123' });
+ */
+export declare function deleteContactActionV2(params: {
+    phoneNumber?: Wid;
+    username?: string;
+    lid?: string;
+}): Promise<void>;

package/dist/whatsapp/functions/saveContactAction.d.ts

@@ -14,9 +14,10 @@
  * limitations under the License.
  */
 /**
+ * Save contact action (legacy positional parameters API)
  * @whatsapp WAWebSaveContactAction >= 2.3000.0
- */
-/**
+ * @deprecated Use saveContactActionV2 instead for versions >= 2.3000.1030209354
+ * @whatsapp WAWebSaveContactAction >= 2.3000.0, < 2.3000.1030209354
  * @param user 5521980809090
  * @param userToDelete 5521980809090
  * @param e_fullName Contact Full Name
@@ -26,3 +27,21 @@
  * @param syncToAddressbook Sync to Addressbook boolean
  */
 export declare function saveContactAction(userToCreate: string, userToDelete: string | null, e_fullName?: any, f_firstName?: any, name?: any, surname?: any, syncToAddressbook?: boolean): Promise<undefined>;
+/**
+ * Object parameter interface for saveContactActionV2 (>= 2.3000.1030209354)
+ */
+export interface SaveContactActionParamsV2 {
+    phoneNumber?: string | null;
+    prevPhoneNumber?: string | null;
+    lid?: string | null;
+    username?: string | null;
+    firstName: string;
+    lastName: string;
+    syncToAddressbook?: boolean;
+}
+/**
+ * Save contact action (new object parameter API)
+ * @whatsapp WAWebSaveContactAction >= 2.3000.1030209354
+ * @param params Contact parameters object
+ */
+export declare function saveContactActionV2(params: SaveContactActionParamsV2): Promise<undefined>;

package/dist/whatsapp/models/ContactModel.d.ts

@@ -32,6 +32,7 @@ interface Props {
     labels?: string[];
     disappearingModeDuration?: any;
     disappearingModeSettingTimestamp?: any;
+    username?: string;
 }
 interface Session {
     stale?: any;