feat(groups): add native sendGroupStatus method and document text group status support

Author: cilldev

docs/content/groups.mdx

@@ -753,6 +753,23 @@ client.on('connect', async () => {
 See [Error Handling](/error-handling) for the full error taxonomy and how to distinguish domain
 errors from builder and automation errors.
 
+## Posting Group Status (`sendGroupStatus`)
+
+```typescript
+client.sendGroupStatus(targetGroupJid: string, content: { text: string; backgroundColor?: number }): Promise<WAMessage>
+```
+
+Posts a **Group Status / Group Story update (`groupStatusMessageV2`)** to the specified group.
+
+> ℹ️ **Feature Status:** Currently, **text-based Group Status** (`text`) is fully supported. Image and video status attachments are currently in active development.
+
+```typescript
+// Post a text Group Status to a group
+await client.sendGroupStatus('120363000000000000@g.us', {
+  text: '📢 Important Group Announcement!',
+})
+```
+
 ## Complete example
 
 The example below creates a group, promotes a member to admin, locks editing to admins, and prints

src/client/client.ts

@@ -1,11 +1,14 @@
 import makeWASocket, {
   fetchLatestBaileysVersion,
+  generateWAMessageContent,
+  generateWAMessageFromContent,
   initAuthCreds,
   type AuthenticationCreds,
   type UserFacingSocketConfig,
   type WAMessage,
   type WAMessageKey,
 } from 'baileys'
+import crypto from 'node:crypto'
 import {
   deleteMessage,
   EditBuilder,
@@ -721,8 +724,8 @@ export class Client extends TypedEventEmitter<ClientEventMap> {
       logger: this.logger,
       onText: (handler) => {
         const wrapped = (msg: MessageContext): void => handler(msg)
-        this.on('text', wrapped)
-        return () => this.off('text', wrapped)
+        this.on('message', wrapped)
+        return () => this.off('message', wrapped)
       },
       buildContext: (resolved, msg) => this.buildCommandContext(resolved, msg),
     })
@@ -859,6 +862,39 @@ export class Client extends TypedEventEmitter<ClientEventMap> {
     await socket.sendMessage(recipient, { disappearingMessagesInChat: seconds } as never)
   }
 
+  async sendGroupStatus(targetJid: string, content: Record<string, unknown>): Promise<WAMessage> {
+    this.assertWebProvider('sendGroupStatus')
+    const socket = this.requireSocket() as any
+    const backgroundColor = content['backgroundColor']
+    const cleanContent: Record<string, unknown> = { ...content }
+    delete cleanContent['backgroundColor']
+
+    const opts: any = {
+      upload: socket.waUploadToServer.bind(socket),
+    }
+    if (backgroundColor != null) {
+      opts.backgroundColor = backgroundColor
+    }
+
+    const inside = await generateWAMessageContent(cleanContent as any, opts)
+
+    const messageSecret = crypto.randomBytes(32)
+
+    const msg = generateWAMessageFromContent(
+      targetJid,
+      {
+        messageContextInfo: { messageSecret },
+        groupStatusMessageV2: {
+          message: Object.assign({}, inside, { messageContextInfo: { messageSecret } }),
+        },
+      },
+      { userJid: socket.user?.id || targetJid }
+    )
+
+    await socket.relayMessage(targetJid, msg.message, { messageId: msg.key.id })
+    return msg
+  }
+
   private resolveRecipient(to: string): Promise<string> {
     return resolveUsername(this.requireSocket() as unknown as UsernameResolveSocketLike, to, this.usernameCache)
   }

src/events/decoders/messages.ts

@@ -81,6 +81,9 @@ const WRAPPER_FIELDS = [
   'documentWithCaptionMessage',
   'editedMessage',
   'lottieStickerMessage',
+  'groupStatusMessageV2',
+  'groupStatusMessage',
+  'groupStatusMentionMessage',
 ] as const
 
 const unwrap = (content: Record<string, unknown>): Record<string, unknown> => {