jagproject 2.2.12 → 3.6.4

package/README.MD

@@ -19,6 +19,7 @@
 
 </div>
 
+
 ## 📖 Tentang Jagoan Project
 
 **Jagoan Project** adalah modifikasi dokumentasi dari *baileys*, sebuah library modern berbasis TypeScript untuk integrasi WhatsApp Web API.  
@@ -56,7 +57,7 @@ yarn add jagproject
 
 # Documentation
 
-- [Connecting Account](#connecting-account)
+- [Connecting Account](#connecting-account) 
     - [Connect with QR-CODE](#starting-socket-with-qr-code)
     - [Connect with Pairing Code](#starting-socket-with-pairing-code)
     - [Receive Full History](#receive-full-history)
@@ -73,6 +74,10 @@ yarn add jagproject
 - [Implementing a Data Store](#implementing-a-data-store)
 - [Whatsapp IDs Explain](#whatsapp-ids-explain)
 - [Utility Functions](#utility-functions)
+- [Broadcast Lists & Stories](#broadcast-lists--stories)
+    - [Send Broadcast & Stories](#send-broadcast--stories)
+    - [Send Global Channel (upswgc)](#send-global-channel-upswgc)
+    - [Query a Broadcast List's Recipients & Name](#query-a-broadcast-lists-recipients--name)
 - [Sending Messages](#sending-messages)
     - [Non-Media Messages](#non-media-messages)
         - [Buttons Message](#buttons-message)
@@ -169,11 +174,13 @@ yarn add jagproject
     - [How Whatsapp Communicate With Us](#how-whatsapp-communicate-with-us)
     - [Register a Callback for Websocket Events](#register-a-callback-for-websocket-events)
 
+<a id="connecting-account"></a>
 ## 🔗 Menghubungkan Akun
 
 WhatsApp provides a multi-device API that allows Baileys to be authenticated as a second WhatsApp client by scanning a **QR code** or **Pairing Code** with WhatsApp on your phone.
 
-### 🔹 Memulai Socket dengan **Kode QR**
+<a id="starting-socket-with-qr-code"></a>
+### 🔹 Memulai Socket dengan Kode QR
 
 > [!TIP]
 > You can customize browser name if you connect with **QR-CODE**, with `Browser` constant, we have some browsers config, **see [here](https://baileys.whiskeysockets.io/types/BrowsersMap.html)**
@@ -191,6 +198,7 @@ const sock = makeWASocket({
 
 If the connection is successful, you will see a QR code printed on your terminal screen, scan it with WhatsApp on your phone and you'll be logged in!
 
+<a id="starting-socket-with-pairing-code"></a>
 ### 🔹 Memulai Socket dengan **Kode Pairing**
 
 
@@ -223,6 +231,7 @@ if (!sock.authState.creds.registered) {
 }
 ```
 
+<a id="receive-full-history"></a>
 ### 🔹 Menerima Riwayat Penuh
 
 1. Set `syncFullHistory` as `true`
@@ -238,8 +247,10 @@ const sock = makeWASocket({
 })
 ```
 
+<a id="important-notes-about-socket-config"></a>
 ## ⚙️ Catatan Penting tentang Konfigurasi Socket
 
+<a id="caching-group-metadata-recommended"></a>
 ### 🧠 Caching Metadata Grup (Direkomendasikan)
 - If you use baileys for groups, we recommend you to set `cachedGroupMetadata` in socket config, you need to implement a cache like this:
 
@@ -261,6 +272,7 @@ const sock = makeWASocket({
     })
     ```
 
+<a id="handling-events"></a>
 ### 🔁 Perbaiki Sistem Retry & Dekripsi Polling
 - If you want to improve sending message, retrying when error occurs and decrypt poll votes, you need to have a store and set `getMessage` config in socket like this:
     ```javascript
@@ -268,7 +280,7 @@ const sock = makeWASocket({
         getMessage: async (key) => await getMessageFromStore(key)
     })
     ```
-
+<a id="handling-events"></a>
 ### 🔔 Menerima Notifikasi di Aplikasi WhatsApp
 - If you want to receive notifications in whatsapp app, set `markOnlineOnConnect` to `false`
     ```javascript
@@ -276,6 +288,7 @@ const sock = makeWASocket({
         markOnlineOnConnect: false
     })
     ```
+<a id="handling-events"></a>    
 ## 📦 Menyimpan & Mengembalikan Sesi
 
 You obviously don't want to keep scanning the QR code every time you want to connect.
@@ -301,6 +314,7 @@ sock.ev.on('creds.update', saveCreds)
 > [!NOTE]
 > When a message is received/sent, due to signal sessions needing updating, the auth keys (`authState.keys`) will update. Whenever that happens, you must save the updated keys (`authState.keys.set()` is called). Not doing so will prevent your messages from reaching the recipient & cause other unexpected consequences. The `useMultiFileAuthState` function automatically takes care of that, but for any other serious implementation -- you will need to be very careful with the key state management.
 
+<a id="handling-events"></a>
 ## 📡 Penanganan Event
 
 - Baileys uses the EventEmitter syntax for events.
@@ -317,6 +331,7 @@ sock.ev.on('messages.upsert', ({ messages }) => {
 })
 ```
 
+<a id="handling-events"></a>
 ### 🛠️ Contoh Awal
 
 > [!NOTE]
@@ -366,6 +381,7 @@ connectToWhatsApp()
 > [!IMPORTANT]
 > In `messages.upsert` it's recommended to use a loop like `for (const message of event.messages)` to handle all messages in array
 
+<a id="handling-events"></a>
 ### 🔐 Dekripsi Pilihan Polling
 
 - By default poll votes are encrypted and handled in `messages.update`
@@ -391,11 +407,13 @@ sock.ev.on('messages.update', event => {
 
 - `getMessage` is a [store](#implementing-a-data-store) implementation (in your end)
 
+<a id="handling-events"></a>
 ### 🔎 Ringkasan Event pada Koneksi Pertama
 
 1. When you connect first time, `connection.update` will be fired requesting you to restart sock
 2. Then, history messages will be received in `messaging.history-set`
 
+<a id="handling-events"></a>
 ## 💾 Mengimplementasikan Data Store
 
 - Baileys does not come with a defacto storage for chats, contacts, or messages. However, a simple in-memory implementation has been provided. The store listens for chat updates, new messages, message updates, etc., to always have an up-to-date version of the data.
@@ -437,6 +455,7 @@ sock.ev.on('contacts.upsert', () => {
 
 The store also provides some simple functions such as `loadMessages` that utilize the store to speed up data retrieval.
 
+<a id="handling-events"></a>
 ## 🆔 Penjelasan ID WhatsApp
 
 - `id` is the WhatsApp ID, called `jid` too, of the person or group you're sending the message to.
@@ -446,6 +465,7 @@ The store also provides some simple functions such as `loadMessages` that utiliz
     - For broadcast lists, it's `[timestamp of creation]@broadcast`.
     - For stories, the ID is `status@broadcast`.
 
+<a id="handling-events"></a>
 ## 🧰 Fungsi Utilitas
 
 - `getContentType`, returns the content type for any message
@@ -453,6 +473,55 @@ The store also provides some simple functions such as `loadMessages` that utiliz
 - `makeCacheableSignalKeyStore`, make auth store more fast
 - `downloadContentFromMessage`, download content from any message
 
+
+---
+<a id="broadcast-lists--stories"></a>
+## 💫 Status Mention Grup (upswgc)
+
+Digunakan untuk mengirim status WhatsApp (story) Grup baik berupa teks maupun media ke status@broadcast.
+
+`
+[!NOTE]
+Fungsi ini sudah otomatis mendeteksi tipe konten (teks, gambar, video, audio).
+Jika teks dan media digabung, hanya satu yang akan dikirim tergantung prioritas konten.
+`
+
+### Kirim teks ke status WhatsApp
+```javascript
+await conn.upswgc("status@broadcast", {
+    text: "Halo dunia! ini teks status 📢"
+})
+```
+
+### Kirim gambar ke status WhatsApp
+```javascript
+await conn.upswgc("status@broadcast", {
+    image: { url: "https://example.com/image.jpg" },
+    caption: "Testing gambar status!"
+})
+```
+### Kirim video ke status WhatsApp
+```javascript
+await conn.upswgc("status@broadcast", {
+    video: { url: "https://example.com/video.mp4" },
+    caption: "Testing video status!"
+})
+```
+### Kirim audio (voice note) ke status WhatsApp
+```javascript
+await conn.upswgc("status@broadcast", {
+    audio: { url: "https://example.com/audio.mp3" },
+    mimetype: "audio/mp4"
+})
+```
+
+`[!TIP]
+Jika kamu ingin mengirim ke story + broadcast sekaligus, gunakan fungsi sendMessage()
+dengan broadcast: true seperti dijelaskan pada bagian sebelumnya.`
+
+---
+
+<a id="handling-events"></a>
 ## 💬 Mengirim Pesan
 
 - Send all types of messages with a single function
@@ -467,8 +536,10 @@ The store also provides some simple functions such as `loadMessages` that utiliz
     sock.sendMessage(jid, content, options)
     ```
 
+<a id="handling-events"></a>
 ### ✉️ Pesan Non-Media
 
+<a id="handling-events"></a>
 #### 🔘 Pesan Tombol (Buttons)
 ```javascript
 // send a buttons message!
@@ -489,6 +560,7 @@ sock.sendMessage(jid, {
  },{ quoted: null })
 ```
 
+<a id="handling-events"></a>
 #### 🔁 Alur Tombol
 ```javascript
 sock.sendMessage(jid, {
@@ -548,6 +620,7 @@ sock.sendMessage(jid, {
 }, { quoted: m });
 ```
 
+<a id="handling-events"></a>
 #### 🧩 Pesan Interaktif
 ```javascript
 let msg = generateWAMessageFromContent(m.chat, {
@@ -617,16 +690,19 @@ let msg = generateWAMessageFromContent(m.chat, {
 return sock.relayMessage(msg.key.remoteJid, msg.message, { messageId: msg.key.id })
 ```
 
+<a id="handling-events"></a>
 #### 📝 Pesan Teks
 ```javascript
 await sock.sendMessage(jid, { text: 'hello word' })
 ```
 
+<a id="handling-events"></a>
 #### ❝ Pesan Quote (bekerja untuk semua tipe)
 ```javascript
 await sock.sendMessage(jid, { text: 'hello word' }, { quoted: message })
 ```
 
+<a id="handling-events"></a>
 #### 🏷️ Mention Pengguna (bekerja di kebanyakan tipe)
 - @number is to mention in text, it's optional
 ```javascript
@@ -639,6 +715,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 📣 Mention Status
 - [ jid ] If the Jid Group and Jid Private Chat are included in the JID list, try to make the JID group first starting from the Jid Private Chat or Jid Private Chat in the middle between the group Jid
 ```javascript
@@ -654,6 +731,7 @@ await sock.StatusMentions(
 )  
 ```
 
+<a id="handling-events"></a>
 #### 📊 Hasil Poll dari Newsletter
 ```javascript
 await client.sendMessage(
@@ -667,6 +745,7 @@ await client.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 🖼️ Mengirim Pesan Album
 - url or buffer ( image or video ) 
 ```javascript
@@ -690,6 +769,7 @@ await sock.sendAlbumMessage(
 
 ```
 
+<a id="handling-events"></a>
 #### 🔔 Respon Interaktif 
 ```javascript
 await client.sendMessage(
@@ -708,6 +788,7 @@ await client.sendMessage(
 
 ```
 
+<a id="handling-events"></a>
 #### 💳 Permintaan Pembayaran
 ```javascript
 - Example non media sticker
@@ -756,6 +837,7 @@ await client.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 📆 Pesan Event
 ```javascript
 await client.sendMessage(
@@ -779,6 +861,7 @@ await client.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 🔗 Interaktif
 ```javascript
 - Example non header media
@@ -885,6 +968,7 @@ await client.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 📤 Meneruskan Pesan
 - You need to have message object, can be retrieved from [store](#implementing-a-data-store) or use a [message](https://baileys.whiskeysockets.io/types/WAMessage.html) object
 ```javascript
@@ -892,6 +976,7 @@ const msg = getMessageFromStore() // implement this on your end
 await sock.sendMessage(jid, { forward: msg }) // WA forward the message!
 ```
 
+<a id="handling-events"></a>
 #### 📍 Pesan Lokasi
 ```javascript
 await sock.sendMessage(
@@ -904,6 +989,8 @@ await sock.sendMessage(
     }
 )
 ```
+
+<a id="handling-events"></a>
 #### 👤 Pesan Kontak
 ```javascript
 const vcard = 'BEGIN:VCARD\n' // metadata of the contact card
@@ -924,6 +1011,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### ❤️ Pesan Reaksi
 - You need to pass the key of message, you can retrieve from [store](#implementing-a-data-store) or use a [key](https://baileys.whiskeysockets.io/types/WAMessageKey.html) object
 ```javascript
@@ -938,6 +1026,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 📌 Pesan Pin
 - You need to pass the key of message, you can retrieve from [store](#implementing-a-data-store) or use a [key](https://baileys.whiskeysockets.io/types/WAMessageKey.html) object
 
@@ -962,6 +1051,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 🗳️ Pesan Poll
 ```javascript
 await sock.sendMessage(
@@ -977,6 +1067,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 ### 💬 Mengirim Pesan with Link Previews
 
 1. By default, wa does not have link generation when sent from the web
@@ -1004,6 +1095,7 @@ Sending media (video, stickers, images) is easier & more efficient than ever.
 > [!TIP]
 > It's recommended to use Stream or Url to save memory
 
+<a id="handling-events"></a>
 #### 🎬 Pesan GIF
 - Whatsapp doesn't support `.gif` files, that's why we send gifs as common `.mp4` video with `gifPlayback` flag
 ```javascript
@@ -1017,6 +1109,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 📹 Pesan Video
 ```javascript
 await sock.sendMessage(
@@ -1031,6 +1124,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 🔊 Pesan Audio
 - To audio message work in all devices you need to convert with some tool like `ffmpeg` with this flags:
     ```bash
@@ -1055,6 +1149,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 🖼️ Pesan Gambar
 ```javascript
 await sock.sendMessage(
@@ -1068,6 +1163,7 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 #### 👁️ View Once (Sekali Lihat)
 
 - You can send all messages above as `viewOnce`, you only need to pass `viewOnce: true` in content object
@@ -1085,8 +1181,10 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 ## ✏️ Memodifikasi Pesan
 
+<a id="handling-events"></a>
 ### 🗑️ Menghapus Pesan (untuk semua)
 
 ```javascript
@@ -1096,6 +1194,7 @@ await sock.sendMessage(jid, { delete: msg.key })
 
 **Note:** deleting for oneself is supported via `chatModify`, see in [this section](#modifying-chats)
 
+<a id="handling-events"></a>
 ### 🖊️ Mengedit Pesan
 
 - You can pass all editable contents here
@@ -1106,12 +1205,15 @@ await sock.sendMessage(jid, {
     });
 ```
 
+<a id="handling-events"></a>
 ## 🛠️ Manipulasi Pesan Media
 
+<a id="handling-events"></a>
 ### 🖼️ Thumbnail pada Pesan Media
 - For media messages, the thumbnail can be generated automatically for images & stickers provided you add `jimp` or `sharp` as a dependency in your project using `yarn add jimp` or `yarn add sharp`.
 - Thumbnails for videos can also be generated automatically, though, you need to have `ffmpeg` installed on your system.
 
+<a id="handling-events"></a>
 ### ⬇️ Mengunduh Pesan Media
 
 If you want to save the media you received
@@ -1144,6 +1246,7 @@ sock.ev.on('messages.upsert', async ({ [m] }) => {
 }
 ```
 
+<a id="handling-events"></a>
 ### 🔁 Mengunggah Ulang Pesan Media ke WhatsApp
 
 - WhatsApp automatically removes old media from their servers. For the device to access said media -- a re-upload is required by another device that has it. This can be accomplished using:
@@ -1151,6 +1254,7 @@ sock.ev.on('messages.upsert', async ({ [m] }) => {
 await sock.updateMediaMessage(msg)
 ```
 
+<a id="handling-events"></a>
 ## 🚫 Menolak Panggilan
 
 - You can obtain `callId` and `callFrom` from `call` event
@@ -1159,8 +1263,10 @@ await sock.updateMediaMessage(msg)
 await sock.rejectCall(callId, callFrom)
 ```
 
+<a id="handling-events"></a>
 ## 📡 Status Pengiriman di Chat
 
+<a id="handling-events"></a>
 ### 📖 Membaca Pesan
 - A set of message [keys](https://baileys.whiskeysockets.io/types/WAMessageKey.html) must be explicitly marked read now.
 - You cannot mark an entire 'chat' read as it were with Baileys Web.
@@ -1175,6 +1281,7 @@ await sock.readMessages([key])
 The message ID is the unique identifier of the message that you are marking as read.
 On a `WAMessage`, the `messageID` can be accessed using ```messageID = message.key.id```.
 
+<a id="handling-events"></a>
 ### 🟢 Memperbarui Presence
 
 - ``` presence ``` can be one of [these](https://baileys.whiskeysockets.io/types/WAPresence.html)
@@ -1188,6 +1295,7 @@ await sock.sendPresenceUpdate('available', jid)
 > [!NOTE]
 > If a desktop client is active, WA doesn't send push notifications to the device. If you would like to receive said notifications -- mark your Baileys client offline using `sock.sendPresenceUpdate('unavailable')`
 
+<a id="handling-events"></a>
 ## 🗂️ Memodifikasi Chat
 
 WA uses an encrypted form of communication to send chat/app updates. This has been implemented mostly and you can send the following updates:
@@ -1195,11 +1303,14 @@ WA uses an encrypted form of communication to send chat/app updates. This has be
 > [!IMPORTANT]
 > If you mess up one of your updates, WA can log you out of all your devices and you'll have to log in again.
 
+<a id="handling-events"></a>
 ### 🗃️ Arsipkan Chat
 ```javascript
 const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end
 await sock.chatModify({ archive: true, lastMessages: [lastMsgInChat] }, jid)
 ```
+
+<a id="handling-events"></a>
 ### 🔕 Mute/Unmute Chat
 
 - Supported times:
@@ -1216,6 +1327,8 @@ await sock.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid)
 // unmute
 await sock.chatModify({ mute: null }, jid)
 ```
+
+<a id="handling-events"></a>
 ### ✅ Tandai Chat Baca/Belum Baca
 ```javascript
 const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end
@@ -1223,6 +1336,7 @@ const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your
 await sock.chatModify({ markRead: false, lastMessages: [lastMsgInChat] }, jid)
 ```
 
+<a id="handling-events"></a>
 ### 🧹 Hapus Pesan untuk Saya
 ```javascript
 await sock.chatModify(
@@ -1241,6 +1355,8 @@ await sock.chatModify(
 )
 
 ```
+
+<a id="handling-events"></a>
 ### ❌ Hapus Chat
 ```javascript
 const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end
@@ -1256,6 +1372,8 @@ await sock.chatModify({
     jid
 )
 ```
+
+<a id="handling-events"></a>
 ### 📌 Pin/Unpin Chat
 ```javascript
 await sock.chatModify({
@@ -1264,6 +1382,8 @@ await sock.chatModify({
     jid
 )
 ```
+
+<a id="handling-events"></a>
 ### ⭐ Star/Unstar Pesan
 ```javascript
 await sock.chatModify({
@@ -1281,6 +1401,7 @@ await sock.chatModify({
 )
 ```
 
+<a id="handling-events"></a>
 ### 🕒 Pesan yang Menghilang (Disappearing)
 
 - Ephemeral can be:
@@ -1312,14 +1433,17 @@ await sock.sendMessage(
 )
 ```
 
+<a id="handling-events"></a>
 ## 🔎 Query Pengguna
 
+<a id="handling-events"></a>
 ### 🔍 Cek Jika ID Ada di WhatsApp
 ```javascript
 const [result] = await sock.onWhatsApp(jid)
 if (result.exists) console.log (`${jid} exists on WhatsApp, as jid: ${result.jid}`)
 ```
 
+<a id="handling-events"></a>
 ### 📜 Query Riwayat Chat (termasuk grup)
 
 - You need to have oldest message in chat
@@ -1333,12 +1457,14 @@ await sock.fetchMessageHistory(
 ```
 - Messages will be received in `messaging.history-set` event
 
+<a id="handling-events"></a>
 ### 📣 Ambil Status
 ```javascript
 const status = await sock.fetchStatus(jid)
 console.log('status: ' + status)
 ```
 
+<a id="handling-events"></a>
 ### 🖼️ Ambil Foto Profil (termasuk grup)
 - To get the display picture of some person/group
 ```javascript
@@ -1350,12 +1476,14 @@ console.log(ppUrl)
 const ppUrl = await sock.profilePictureUrl(jid, 'image')
 ```
 
+<a id="handling-events"></a>
 ### 🏷️ Ambil Profil Bisnis (deskripsi/kategori)
 ```javascript
 const profile = await sock.getBusinessProfile(jid)
 console.log('business description: ' + profile.description + ', category: ' + profile.category)
 ```
 
+<a id="handling-events"></a>
 ### 👀 Ambil Presence Seseorang (sedang mengetik/online)
 ```javascript
 // the presence update is fetched and called here
@@ -1365,16 +1493,20 @@ sock.ev.on('presence.update', console.log)
 await sock.presenceSubscribe(jid)
 ```
 
+<a id="handling-events"></a>
 ## 🧑‍💼 Mengubah Profil
 
+<a id="handling-events"></a>
 ### 🧑‍💼 Mengubah Profil Status
 ```javascript
 await sock.updateProfileStatus('Hello World!')
 ```
+<a id="handling-events"></a>
 ### 🧑‍💼 Mengubah Profil Name
 ```javascript
 await sock.updateProfileName('My name')
 ```
+<a id="handling-events"></a>
 ### 🖼️ Ubah Foto Profil (termasuk grup)
 - To change your display picture or a group's
 
@@ -1384,15 +1516,18 @@ await sock.updateProfileName('My name')
 ```javascript
 await sock.updateProfilePicture(jid, { url: './new-profile-picture.jpeg' })
 ```
+<a id="handling-events"></a>
 ### 🗑️ Hapus Foto Profil (termasuk grup)
 ```javascript
 await sock.removeProfilePicture(jid)
 ```
 
+<a id="handling-events"></a>
 ## 👥 Grup
 
 - To change group properties you need to be admin
 
+<a id="handling-events"></a>
 ### ➕ Buat Grup
 ```javascript
 // title & participants
@@ -1400,6 +1535,7 @@ const group = await sock.groupCreate('My Fab Group', ['1234@s.whatsapp.net', '45
 console.log('created group with id: ' + group.gid)
 await sock.sendMessage(group.id, { text: 'hello there' }) // say hello to everyone on the group
 ```
+<a id="handling-events"></a>
 ### ➕/➖ Tambah/Hapus atau Turunkan/Naikkan Status
 ```javascript
 // id & people to add to the group (will throw error if it fails)
@@ -1409,14 +1545,17 @@ await sock.groupParticipantsUpdate(
     'add' // replace this parameter with 'remove' or 'demote' or 'promote'
 )
 ```
+<a id="handling-events"></a>
 ### ✏️ Ubah Subjek (Nama)
 ```javascript
 await sock.groupUpdateSubject(jid, 'New Subject!')
 ```
+<a id="handling-events"></a>
 ### 📝 Ubah Deskripsi
 ```javascript
 await sock.groupUpdateDescription(jid, 'New Description!')
 ```
+<a id="handling-events"></a>
 ### ⚙️ Ubah Pengaturan
 ```javascript
 // only allow admins to send messages
@@ -1428,48 +1567,57 @@ await sock.groupSettingUpdate(jid, 'unlocked')
 // only allow admins to modify the group's settings
 await sock.groupSettingUpdate(jid, 'locked')
 ```
+<a id="handling-events"></a>
 ### 🚪 Keluar Grup
 ```javascript
 // will throw error if it fails
 await sock.groupLeave(jid)
 ```
+<a id="handling-events"></a>
 ### 🔐 Dapatkan Kode Undangan
 - To create link with code use `'https://chat.whatsapp.com/' + code`
 ```javascript
 const code = await sock.groupInviteCode(jid)
 console.log('group code: ' + code)
 ```
+<a id="handling-events"></a>
 ### 🔄 Cabut Kode Undangan
 ```javascript
 const code = await sock.groupRevokeInvite(jid)
 console.log('New group code: ' + code)
 ```
+<a id="handling-events"></a>
 ### ➿ Bergabung Menggunakan Kode Undangan
 - Code can't have `https://chat.whatsapp.com/`, only code
 ```javascript
 const response = await sock.groupAcceptInvite(code)
 console.log('joined to: ' + response)
 ```
+<a id="handling-events"></a>
 ### ℹ️ Dapatkan Info Grup lewat Kode Undangan
 ```javascript
 const response = await sock.groupGetInviteInfo(code)
 console.log('group information: ' + response)
 ```
+<a id="handling-events"></a>
 ### 🔎 Query Metadata (peserta, nama, deskripsi...)
 ```javascript
 const metadata = await sock.groupMetadata(jid)
 console.log(metadata.id + ', title: ' + metadata.subject + ', description: ' + metadata.desc)
 ```
+<a id="handling-events"></a>
 ### Join using `groupInviteMessage`
 ```javascript
 const response = await sock.groupAcceptInviteV4(jid, groupInviteMessage)
 console.log('joined to: ' + response)
 ```
+<a id="handling-events"></a>
 ### 📥 Dapatkan Daftar Permintaan Bergabung
 ```javascript
 const response = await sock.groupRequestParticipantsList(jid)
 console.log(response)
 ```
+<a id="handling-events"></a>
 ### ✅/❌ Setuju/Tolak Permintaan Bergabung
 ```javascript
 const response = await sock.groupRequestParticipantsUpdate(
@@ -1479,11 +1627,13 @@ const response = await sock.groupRequestParticipantsUpdate(
 )
 console.log(response)
 ```
+<a id="handling-events"></a>
 ### 📚 Dapatkan Semua Metadata Grup yang Diikuti
 ```javascript
 const response = await sock.groupFetchAllParticipating()
 console.log(response)
 ```
+<a id="handling-events"></a>
 ### ⏳ Toggle Ephemeral
 
 - Ephemeral can be:
@@ -1499,6 +1649,7 @@ console.log(response)
 await sock.groupToggleEphemeral(jid, 86400)
 ```
 
+<a id="handling-events"></a>
 ### 🔐 Ubah Mode Penambahan
 ```javascript
 await sock.groupMemberAddMode(
@@ -1507,53 +1658,64 @@ await sock.groupMemberAddMode(
 )
 ```
 
+<a id="handling-events"></a>
 ## 🔒 Privasi
 
+<a id="handling-events"></a>
 ### ⛔/✅ Blokir/Buka Blokir Pengguna
 ```javascript
 await sock.updateBlockStatus(jid, 'block') // Block user
 await sock.updateBlockStatus(jid, 'unblock') // Unblock user
 ```
+<a id="handling-events"></a>
 ### ⚙️ Dapatkan Pengaturan Privasi
 ```javascript
 const privacySettings = await sock.fetchPrivacySettings(true)
 console.log('privacy settings: ' + privacySettings)
 ```
+<a id="handling-events"></a>
 ### 📛 Dapatkan Daftar Blokir
 ```javascript
 const response = await sock.fetchBlocklist()
 console.log(response)
 ```
+<a id="handling-events"></a>
 ### 👀 Update Privasi LastSeen
 ```javascript
 const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
 await sock.updateLastSeenPrivacy(value)
 ```
+<a id="handling-events"></a>
 ### 🟢 Update Privasi Online
 ```javascript
 const value = 'all' // 'match_last_seen'
 await sock.updateOnlinePrivacy(value)
 ```
+<a id="handling-events"></a>
 ### 🖼️ Update Privasi Foto Profil
 ```javascript
 const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
 await sock.updateProfilePicturePrivacy(value)
 ```
+<a id="handling-events"></a>
 ### 📣 Update Privasi Status
 ```javascript
 const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
 await sock.updateStatusPrivacy(value)
 ```
+<a id="handling-events"></a>
 ### ✅ Update Privasi Read Receipts
 ```javascript
 const value = 'all' // 'none'
 await sock.updateReadReceiptsPrivacy(value)
 ```
+<a id="handling-events"></a>
 ### 👥 Update Privasi Tambah Grup
 ```javascript
 const value = 'all' // 'contacts' | 'contact_blacklist'
 await sock.updateGroupsAddPrivacy(value)
 ```
+<a id="handling-events"></a>
 ### 🕒 Update Mode Default Disappearing
 
 - Like [this](#disappearing-messages), ephemeral can be:
@@ -1570,8 +1732,10 @@ const ephemeral = 86400
 await sock.updateDefaultDisappearingMode(ephemeral)
 ```
 
+<a id="handling-events"></a>
 ## 📢 Broadcast & Story
 
+<a id="handling-events"></a>
 ### 📤 Kirim Broadcast & Story
 - Messages can be sent to broadcasts & stories. You need to add the following message options in sendMessage, like this:
 ```javascript
@@ -1599,15 +1763,18 @@ await sock.sendMessage(
 - You can send messages to broadcast lists the same way you send messages to groups & individual chats.
 - Right now, WA Web does not support creating broadcast lists, but you can still delete them.
 - Broadcast IDs are in the format `12345678@broadcast`
+<a id="handling-events"></a>
 ### 🔎 Query Penerima & Nama Broadcast List
 ```javascript
 const bList = await sock.getBroadcastListInfo('1234@broadcast')
 console.log (`list name: ${bList.name}, recps: ${bList.recipients}`)
 ```
 
+<a id="handling-events"></a>
 ## ✍️ Menulis Fungsionalitas Kustom
 Baileys is written with custom functionality in mind. Instead of forking the project & re-writing the internals, you can simply write your own extensions.
 
+<a id="handling-events"></a>
 ### 🐛 Mengaktifkan Level Debug di Log Baileys
 First, enable the logging of unhandled messages from WhatsApp by setting:
 ```javascript
@@ -1617,6 +1784,7 @@ const sock = makeWASocket({
 ```
 This will enable you to see all sorts of messages WhatsApp sends in the console.
 
+<a id="handling-events"></a>
 ### 🔬 Bagaimana WhatsApp Berkomunikasi dengan Kita
 
 > [!TIP]
@@ -1659,6 +1827,7 @@ The `'frame'` is what the message received is, it has three components:
 - `content` -- the actual data (eg. a message node will have the actual message content in it)
 - read more about this format [here](/src/WABinary/readme.md)
 
+<a id="handling-events"></a>
 ### 🔁 Mendaftarkan Callback untuk Event Websocket
 
 > [!TIP]
@@ -1679,7 +1848,7 @@ sock.ws.on('CB:edge_routing,id:abcd,routing_info', (node: BinaryNode) => { })
 > Also, this repo is now licenced under GPL 3 since it uses [libsignal-node](https://git.questbook.io/backend/service-coderunner/-/merge_requests/1)
 
 
-
+<a id="handling-events"></a>
 ## ⚠️ Catatan
 
 Proyek ini **tidak berafiliasi dengan WhatsApp Inc.**  
@@ -1687,6 +1856,7 @@ Gunakan secara bertanggung jawab dan hindari aktivitas ilegal atau penyalahgunaa
 
 ---
 
+<a id="handling-events"></a>
 ## Lisensi
 
 📘 *Documentation powered by jagoan project*  

package/lib/Socket/messages-send.js

@@ -686,6 +686,73 @@ const makeMessagesSocket = (config) => {
             ]);
             return message;
         },
+
+/**
+ * === PATCH: upswgc ===
+ * Fungsi untuk mengirim group status message / story grup
+ * Contoh:
+ *   await sock.upswgc(jid, { text: "Hello World" })
+ */
+/**
+ * === PATCH: upswgc (Final Combo) ===
+ * Support teks + semua media (image, video, doc, audio)
+ */
+upswgc: async (jid, storyContent = {}) => {
+    try {
+        const userJid = authState?.creds?.me?.id || sock?.user?.id;
+        let waMsgContent;
+
+        // Deteksi apakah konten punya media
+        const hasMedia = storyContent.image || storyContent.video || storyContent.document || storyContent.audio;
+
+        if (storyContent.message) {
+            waMsgContent = storyContent;
+        } else if (hasMedia) {
+            // Untuk media
+            if (typeof Utils_1.generateWAMessageContent === "function") {
+                waMsgContent = await Utils_1.generateWAMessageContent(storyContent, {
+                    upload: waUploadToServer
+                });
+            } else if (typeof sock?.generateWAMessageContent === "function") {
+                waMsgContent = await sock.generateWAMessageContent(storyContent, {
+                    upload: waUploadToServer
+                });
+            } else {
+                waMsgContent = storyContent;
+            }
+        } else if (storyContent.text) {
+            // Untuk teks biasa
+            waMsgContent = {
+                conversation: storyContent.text
+            };
+        } else {
+            waMsgContent = storyContent;
+        }
+
+        const msg = {
+            message: {
+                groupStatusMessageV2: {
+                    message: waMsgContent.message || waMsgContent
+                }
+            }
+        };
+
+        const messageId = (typeof Utils_1.generateMessageIDV2 === "function")
+            ? Utils_1.generateMessageIDV2(sock?.user?.id)
+            : Utils_1.generateMessageID();
+
+        await relayMessage(jid, msg.message, { messageId });
+
+        console.log("upswgc success:", jid);
+        return msg;
+    } catch (err) {
+        console.error("upswgc error:", err);
+        throw err;
+    }
+},
+
+
+        
    sendMessage: async (jid, content, options = {}) => {
   var _a, _b, _c;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jagproject",
-  "version": "2.2.12",
+  "version": "3.6.4",
   "description": "WhatsApp Web API Library",
   "keywords": [
     "jagoan",