@wppconnect/wa-js 3.22.1 → 3.23.1

package/CHANGELOG.md

@@ -1,9 +1,9 @@
-## 3.22.1 (2026-02-28)
+## 3.23.1 (2026-03-04)
 
 
 ### Bug Fixes
 
-* getMessages (msgs.push is not a function) ([#3364](https://github.com/wppconnect-team/wa-js/issues/3364)) ([bdd2224](https://github.com/wppconnect-team/wa-js/commit/bdd222400e594e98b74cadc06a3a21eef3f2ecd8))
+* event name to follow project pattern ([#3371](https://github.com/wppconnect-team/wa-js/issues/3371)) ([217158d](https://github.com/wppconnect-team/wa-js/commit/217158dc21dc1586168c254a564bd50f9b32cb43))
 
 
 

package/README.md

@@ -58,6 +58,8 @@ There are convention names for some exported modules:
 
 `WPP.conn.getBuildConstants` - Current WhatsApp build constants
 
+`WPP.conn.getStreamData` - Get current stream mode and info (connection state)
+
 For the most up-to-date list of available functions, launch the project locally and run this in your browser console:
 
 `Object.keys(WPP.conn).sort()`
@@ -131,6 +133,50 @@ For the most up-to-date list of available functions, launch the project locally
 `Object.keys(WPP.group).sort()`
 
 ### Events
+
+#### Connection Events
+
+`WPP.on('conn.stream_mode_changed', callback)` - Triggered when the connection mode changes
+
+Stream modes:
+- `QR` - QR code is displayed, waiting for scan
+- `MAIN` - Main interface is loaded and ready
+- `SYNCING` - Syncing messages and data
+- `OFFLINE` - Connection is offline
+- `CONFLICT` - Login conflict detected
+- `PROXYBLOCK` - Blocked by proxy
+- `TOS_BLOCK` - Blocked for Terms of Service violation
+- `SMB_TOS_BLOCK` - SMB blocked for Terms of Service violation
+- `DEPRECATED_VERSION` - WhatsApp version is deprecated
+
+```javascript
+WPP.on('conn.stream_mode_changed', (mode) => {
+  console.log('Connection mode:', mode);
+  if (mode === 'MAIN') {
+    console.log('WhatsApp is ready!');
+  }
+});
+```
+
+`WPP.on('conn.stream_info_changed', callback)` - Triggered when the internal connection state changes
+
+Stream info states:
+- `OFFLINE` - Connection is offline
+- `OPENING` - Opening connection
+- `PAIRING` - Pairing with phone
+- `SYNCING` - Syncing messages
+- `RESUMING` - Resuming connection
+- `CONNECTING` - Connecting to server
+- `NORMAL` - Normal operation
+
+```javascript
+WPP.on('conn.stream_info_changed', (info) => {
+  console.log('Connection state:', info);
+});
+```
+
+#### Chat Events
+
 `WPP.chat.on('chat.new_message')` - Event to dispatch on receive a new message
 
 To see all events, check: [https://wppconnect.io/wa-js/types/ev.EventTypes.html](https://wppconnect.io/wa-js/types/ev.EventTypes.html)

package/dist/conn/events/eventTypes.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { LogoutReason } from '../../whatsapp/enums';
+import { LogoutReason, StreamInfo, StreamMode } from '../../whatsapp/enums';
 import { AuthCode } from '../types';
 export interface ConnEventTypes {
     'conn.auth_code_change': AuthCode | null;
@@ -91,4 +91,26 @@ export interface ConnEventTypes {
     'conn.online': boolean;
     'conn.qrcode_idle': undefined;
     'conn.require_auth': undefined;
+    /**
+     * Triggered when the stream mode changes
+     *
+     * @example
+     * ```javascript
+     * WPP.on('conn.stream_mode_changed', (mode) => {
+     *   console.log('Stream mode changed to:', mode);
+     * });
+     * ```
+     */
+    'conn.stream_mode_changed': StreamMode;
+    /**
+     * Triggered when the stream info changes
+     *
+     * @example
+     * ```javascript
+     * WPP.on('conn.stream_info_changed', (info) => {
+     *   console.log('Stream info changed to:', info);
+     * });
+     * ```
+     */
+    'conn.stream_info_changed': StreamInfo;
 }

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

@@ -24,3 +24,4 @@ import './registerNeedsUpdateEvent';
 import './registerOnlineEvent';
 import './registerQRCodeIdleEvent';
 import './registerRequireAuthEvent';
+import './registerStreamEvent';

package/dist/conn/events/registerMainReadyEvent.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Copyright 2021 WPPConnect Team
+ * Copyright 2026 WPPConnect Team
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/dist/conn/events/registerStreamEvent.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * 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.
+ */
+export {};

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

@@ -0,0 +1,31 @@
+/*!
+ * Copyright 2026 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 { StreamInfo, StreamMode } from '../../whatsapp/enums';
+export interface StreamData {
+    mode: StreamMode;
+    info: StreamInfo | undefined;
+}
+/**
+ * Get current stream mode and info
+ *
+ * @example
+ * ```javascript
+ * const streamData = WPP.conn.getStreamData();
+ * console.log(streamData.mode); // 'MAIN', 'QR', 'SYNCING', etc.
+ * console.log(streamData.info); // 'NORMAL', 'OPENING', 'SYNCING', etc.
+ * ```
+ */
+export declare function getStreamData(): StreamData;

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

@@ -26,6 +26,7 @@ export { getMyUserId } from './getMyUserId';
 export { getMyUserLid } from './getMyUserLid';
 export { getMyUserWid } from './getMyUserWid';
 export { getPlatform } from './getPlatform';
+export { getStreamData, StreamData } from './getStreamData';
 export { getTheme, Theme } from './getTheme';
 export { isAuthenticated } from './isAuthenticated';
 export { isIdle } from './isIdle';

package/dist/whatsapp/enums/StreamInfo.d.ts

@@ -0,0 +1,28 @@
+/*!
+ * Copyright 2026 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.
+ */
+/**
+ * StreamInfo represents the internal connection state
+ * @whatsapp 2.3000.x
+ */
+export declare enum StreamInfo {
+    OFFLINE = "OFFLINE",
+    OPENING = "OPENING",
+    PAIRING = "PAIRING",
+    SYNCING = "SYNCING",
+    RESUMING = "RESUMING",
+    CONNECTING = "CONNECTING",
+    NORMAL = "NORMAL"
+}

package/dist/whatsapp/enums/StreamMode.d.ts

@@ -0,0 +1,30 @@
+/*!
+ * Copyright 2026 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.
+ */
+/**
+ * StreamMode represents the connection state mode
+ * @whatsapp 2.3000.x
+ */
+export declare enum StreamMode {
+    QR = "QR",
+    MAIN = "MAIN",
+    SYNCING = "SYNCING",
+    OFFLINE = "OFFLINE",
+    CONFLICT = "CONFLICT",
+    PROXYBLOCK = "PROXYBLOCK",
+    TOS_BLOCK = "TOS_BLOCK",
+    SMB_TOS_BLOCK = "SMB_TOS_BLOCK",
+    DEPRECATED_VERSION = "DEPRECATED_VERSION"
+}

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

@@ -24,3 +24,5 @@ export * from './OUTWARD_TYPES';
 export * from './PIN_STATE';
 export * from './PinExpiryDurationOption';
 export * from './SendMsgResult';
+export * from './StreamInfo';
+export * from './StreamMode';

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

@@ -13,25 +13,26 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { StreamInfo, StreamMode } from '../enums';
 import { Model, ModelOptions, ModelPropertiesContructor, ModelProxy } from './Model';
 interface Props {
 }
 interface Session {
-    info?: any;
-    mode: string;
+    info?: StreamInfo;
+    mode: StreamMode;
     obscurity?: any;
     needsUpdate?: any;
-    clientExpired?: any;
-    hardExpired?: any;
+    isHardRefresh?: boolean;
     lastSyncStart?: any;
     needsManualDownload?: any;
     couldForce?: any;
     uiActive?: any;
+    isInConnectedCall?: boolean;
     available?: any;
     unavailableShiftTimer?: any;
+    unavailableAutoLockTimer?: any;
     unavailableLogoutTimer?: any;
     unobscureShiftTimer?: any;
-    timeoutEvent?: any;
     resumeCount?: any;
     phoneAuthed?: any;
 }
@@ -48,16 +49,13 @@ export declare interface StreamModel extends ModelProxy<Props, Session, Derived>
  */
 export declare class StreamModel extends Model {
     constructor(proterties?: ModelPropertiesContructor<StreamModel>, options?: ModelOptions);
+    initialize(): void;
+    delete(): void;
     markAvailable(): void;
     markUnavailable(e?: any): void;
-    onSelfUpdate(): void;
-    onSocketUpdate(): void;
     unobscure(): void;
-    onPhoneAuthedUpdate(): void;
-    onAvailableUpdate(): void;
     sendAvailability(e?: any): void;
     updateCouldForce(): void;
-    updateHardExpire(): void;
     logPageResume(): void;
     updateWamLog(): void;
     logModeChange(): void;