@wppconnect/wa-js 3.19.5 → 3.19.6

package/CHANGELOG.md

@@ -1,4 +1,4 @@
-## 3.19.5 (2026-01-12)
+## 3.19.6 (2026-01-15)
 
 
 

package/README.md

@@ -169,6 +169,28 @@ To debug or inspect `wa-source` folder, format the files to be easier to underst
 npm run wa-source:format
 ```
 
+### Comparing WhatsApp Web Versions
+
+To compare changes between two WhatsApp Web versions, use the helper script:
+
+Note: You need to run locally in multiple versions to download the scripts to wa-source folder, otherwise will not have anything to compare. To do it use: `WA_VERSION="<version-here>" npm run launch:local`
+
+```bash
+# Compare two versions (overview of module differences)
+./scripts/compare-wa-versions.sh 2.3000.1031980585 2.3000.1031992593
+
+# Compare a specific module between versions
+./scripts/compare-wa-versions.sh 2.3000.1031980585 2.3000.1031992593 WAWebUpdateUnreadChatAction
+
+# List available versions
+./scripts/compare-wa-versions.sh
+```
+
+This is useful for:
+- Tracking API changes between WhatsApp Web updates
+- Identifying when function signatures changed
+- Finding new or removed modules
+
 ## How to use this project
 
 Basically, you need to inject the `wppconnect-wa.js` file into the browser after WhatsApp page load.

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

@@ -0,0 +1,83 @@
+/*!
+ * Copyright 2021 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { RawABPropConfig } from '../../whatsapp/functions/abPropsCache';
+/**
+ * A/B test property configuration
+ */
+export interface ABPropConfig extends RawABPropConfig {
+    /** The human-readable config name (e.g., "web_pwa_background_sync") */
+    name: string | null;
+}
+/**
+ * Get all A/B test property configurations for the current session
+ * These are experimental flags that WhatsApp uses for feature testing
+ *
+ * @example
+ * ```javascript
+ * // Get all A/B props as an array
+ * const abProps = WPP.conn.getABProps();
+ * console.log('Total A/B props:', abProps.length);
+ *
+ * // Log each prop with its name
+ * abProps.forEach(prop => {
+ *   console.log(`${prop.name}: ${prop.configValue}`);
+ * });
+ * ```
+ *
+ * @returns {ABPropConfig[]} Array of A/B property configurations with names
+ */
+export declare function getABProps(): ABPropConfig[];
+/**
+ * Get all A/B test property configurations as a Map
+ * The map is keyed by the config code for easier lookup
+ *
+ * @example
+ * ```javascript
+ * // Get all A/B props as a Map
+ * const abPropsMap = WPP.conn.getABPropsMap();
+ *
+ * // Check a specific config by code
+ * const specificProp = abPropsMap.get('12345');
+ * if (specificProp) {
+ *   console.log('Name:', specificProp.name);
+ *   console.log('Value:', specificProp.configValue);
+ * }
+ *
+ * // Convert to object for easy viewing
+ * const result = {};
+ * abPropsMap.forEach((value, key) => {
+ *   result[value.name || key] = value.configValue;
+ * });
+ * console.table(result);
+ * ```
+ *
+ * @returns {Map<string, ABPropConfig>} Map of config code to A/B property configuration with names
+ */
+export declare function getABPropsMap(): Map<string, ABPropConfig>;
+/**
+ * Get the human-readable name of an A/B config from its code
+ *
+ * @example
+ * ```javascript
+ * // Get name from config code
+ * const name = WPP.conn.getABPropName('12345');
+ * console.log('Config name:', name);
+ * ```
+ *
+ * @param configCode - The numeric config code
+ * @returns {string|null} The human-readable config name or null if not found
+ */
+export declare function getABPropName(configCode: string): string | null;

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

@@ -15,6 +15,7 @@
  */
 export { changeEnviromentDevice } from './changeEnviromentDevice';
 export { genLinkDeviceCodeForPhoneNumber } from './genLinkDeviceCodeForPhoneNumber';
+export { ABPropConfig, getABPropName, getABProps, getABPropsMap, } from './getABProps';
 export { getAuthCode } from './getAuthCode';
 export { BuildConstants, getBuildConstants, isWhatsAppVersionGTE, } from './getBuildConstants';
 export { getHistorySyncProgress, HistorySyncProgress, } from './getHistorySyncProgress';

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

@@ -0,0 +1,36 @@
+/*!
+ * Copyright 2021 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Raw A/B test property configuration from WhatsApp
+ */
+export interface RawABPropConfig {
+    /** The internal config code (numeric key) */
+    configCode: string;
+    /** The actual value of the config (string, number, boolean) */
+    configValue: any;
+    /** Exposure key for analytics tracking */
+    configExpoKey?: string;
+    /** Whether this config has been accessed during this session */
+    hasAccessed?: boolean;
+    /** Override value if set via URL parameter */
+    overriddenConfigValue?: any;
+}
+/**
+ * @whatsapp WAWebABPropsCache
+ */
+export declare function getAllABPropConfigs(): RawABPropConfig[];
+export declare function getAllABPropsMap(): Map<string, RawABPropConfig>;
+export declare function getABPropConfigNameFromCode(configCode: number | string): string | undefined;

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

@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+export * from './abPropsCache';
 export * from './addAndSendMessageEdit';
 export * from './addAndSendMsgToChat';
 export * from './addProductToCart';

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

@@ -14,14 +14,23 @@
  * limitations under the License.
  */
 import { ChatModel, MsgModel } from '../models';
-/** @whatsapp 9609
- * @whatsapp 561498 >= 2.2228.4
+/**
+ * @whatsapp WAWebUpdateUnreadChatAction >= 2.3000.1031992593
  */
-export declare function markUnread(chat: ChatModel, whenAvailable: boolean): Promise<ChatModel>;
-/** @whatsapp 9609
+export declare function markUnread(chat: ChatModel, whenAvailable: boolean, showToast?: boolean): Promise<ChatModel>;
+/**
  * @whatsapp 561498 >= 2.2228.4
+ * @deprecated Use sendSeen({chat}) for versions >= 2.3000.1031992593
  */
 export declare function sendSeen(chat: ChatModel, whenAvailable: boolean): Promise<ChatModel>;
+/**
+ * @whatsapp WAWebUpdateUnreadChatAction >= 2.3000.1031992593
+ */
+export declare function sendSeen(options: {
+    chat: ChatModel;
+    threadId?: string | null;
+    afterAvailable?: boolean;
+}): Promise<void>;
 /** @whatsapp 30734
  * @whatsapp 730734 >= 2.2222.8
  * @whatsapp 242050 >= 2.2228.4

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

@@ -15,6 +15,12 @@
  */
 import { Wid } from '../misc';
 /**
+ * @deprecated Use toUserLidOrThrow instead. This function will be removed in future versions.
+ * This function was removed from WhatsApp Web since (2.3000.1031992593~) but is still available here for backward compatibility.
  * @whatsapp WAWebLidMigrationUtils >= 2.3000.x
  */
 export declare function toUserLid(wid: Wid): Wid;
+/**
+ * @whatsapp WAWebLidMigrationUtils >= 2.3000.1032013519
+ */
+export declare function toUserLidOrThrow(wid: Wid): Wid;