baileys-joss 1.0.1 → 1.0.2

package/README.md

@@ -37,6 +37,12 @@
   <a href="./docs/README.en.md">🇺🇸 English</a>
 </p>
 
+<p align="center">
+  <b>🎮 Full Demo:</b>
+  <a href="https://gist.github.com/firdausmntp/07f4698578a38b63d2ff0f8990fdb2ee">📝 Complete Example Code (Gist)</a> |
+  <a href="./Example/wa-baileys-joss-complete.js">📁 Local Example File</a>
+</p>
+
 ---
 
 ## ✨ Kenapa Baileys-Joss?
@@ -117,6 +123,141 @@
 <td align="center">❌</td>
 <td align="center">✅</td>
 </tr>
+<tr>
+<td>📸 HD Images (Uncompressed)</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>🎬 HD Videos (Uncompressed)</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>🌄 Panorama Profile Picture</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>📅 Message Scheduling</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>📨 Bulk Messaging</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>🔄 Auto Reply System</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>📇 Contact Card (vCard)</td>
+<td align="center">⚠️ Basic</td>
+<td align="center">✅ Enhanced</td>
+</tr>
+<tr>
+<td>📺 Status/Story Posting</td>
+<td align="center">⚠️ Basic</td>
+<td align="center">✅ Enhanced</td>
+</tr>
+<tr>
+<td>🎤 Voice Note Helper</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>📋 Message Templates</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>📡 Broadcast Manager</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>⌨️ Typing Indicator</td>
+<td align="center">⚠️ Basic</td>
+<td align="center">✅ Enhanced</td>
+</tr>
+<tr>
+<td>✅ Read Receipt Control</td>
+<td align="center">⚠️ Basic</td>
+<td align="center">✅ Enhanced</td>
+</tr>
+<tr>
+<td>🔍 Message Search</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>📊 Chat Analytics</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>💾 Chat Export</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>🔗 QR Code Generator</td>
+<td align="center">⚠️ Basic</td>
+<td align="center">✅ Enhanced</td>
+</tr>
+<tr>
+<td>📁 Media Downloader</td>
+<td align="center">❌</td>
+<td align="center">✅</td>
+</tr>
+<tr>
+<td>🎮 Mini Games</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
+<tr>
+<td>🔍 Content Detector</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
+<tr>
+<td>🛡️ Anti-Spam System</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
+<tr>
+<td>🔗 Link Scanner</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
+<tr>
+<td>📝 Activity Logger</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
+<tr>
+<td>🎭 Meme Generator</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
+<tr>
+<td>🍅 Pomodoro Timer</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
+<tr>
+<td>💬 Quote Generator</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
+<tr>
+<td>🌤️ Weather Bot</td>
+<td align="center">❌</td>
+<td align="center">⚠️ Untested</td>
+</tr>
 </table>
 
 ---
@@ -301,6 +442,60 @@ await sock.sendMessage(jid, {
 
 </details>
 
+<details>
+<summary><h3>📸 HD Images & Videos (Uncompressed)</h3></summary>
+
+Kirim gambar dan video tanpa kompresi dalam kualitas HD:
+
+```typescript
+// Kirim gambar HD (kualitas tinggi, tidak dikompres)
+await sock.sendMessage(jid, {
+    image: { url: './photo-hd.jpg' },
+    caption: 'Foto HD 📸',
+    hd: true  // Kirim tanpa kompresi
+})
+
+// Kirim video HD
+await sock.sendMessage(jid, {
+    video: { url: './video-4k.mp4' },
+    caption: 'Video 4K 🎬',
+    hd: true  // Kualitas asli
+})
+
+// HD dengan media dari URL
+await sock.sendMessage(jid, {
+    image: { url: 'https://example.com/high-res-photo.jpg' },
+    hd: true,
+    caption: 'High Resolution Photo'
+})
+```
+
+</details>
+
+<details>
+<summary><h3>🌄 Panorama Profile Picture</h3></summary>
+
+Set foto profil panorama (wide) tanpa cropping:
+
+```typescript
+// Set panorama profile picture (tidak di-crop square)
+await sock.updatePanoramaProfilePicture(myJid, { url: './panorama.jpg' })
+
+// Dengan opsi kustom
+await sock.updatePanoramaProfilePicture(myJid, { url: './wide-photo.jpg' }, {
+    maxWidth: 1080,  // Maximum width
+    quality: 90      // JPEG quality (1-100)
+})
+
+// Set panorama untuk grup
+await sock.updatePanoramaProfilePicture(groupJid, { url: './group-banner.jpg' })
+
+// Atau gunakan profile picture biasa (square crop)
+await sock.updateProfilePicture(myJid, { url: './square-photo.jpg' })
+```
+
+</details>
+
 <details>
 <summary><h3>📊 Poll Creation</h3></summary>
 
@@ -743,111 +938,1820 @@ await sock.groupParticipantsUpdate(group.id, [
 
 ---
 
-## 📋 API Reference
+## 🆕 Baileys-Joss v1.0.2 New Features
 
 <details>
-<summary><b>🖱️ Interactive Messages</b></summary>
+<summary><h3>📅 Message Scheduling</h3></summary>
 
-| Function | Description |
-|----------|-------------|
-| `generateInteractiveButtonMessage()` | Buat button message dengan media header |
-| `generateInteractiveListMessage()` | Buat list message dengan sections |
-| `generateTemplateMessage()` | Buat template message (Quick Reply, URL, Call) |
-| `generateNativeFlowMessage()` | Buat native flow message (format terbaru) |
-| `generateCopyCodeButton()` | Button untuk copy code |
-| `generateUrlButtonMessage()` | Button dengan URL |
-| `generateQuickReplyButtons()` | Quick reply buttons |
-| `generateCombinedButtons()` | Gabungan berbagai jenis button |
+Jadwalkan pesan untuk dikirim otomatis di waktu tertentu:
 
-</details>
+```typescript
+import { createMessageScheduler } from 'baileys-joss'
+
+// Buat scheduler
+const scheduler = createMessageScheduler(
+    (jid, content) => sock.sendMessage(jid, content),
+    {
+        onSent: (scheduled, message) => {
+            console.log(`Pesan terkirim ke ${scheduled.jid}`)
+        },
+        onFailed: (scheduled, error) => {
+            console.log(`Gagal kirim: ${error.message}`)
+        }
+    }
+)
 
-<details>
-<summary><b>📍 JID Plotting</b></summary>
+// Jadwalkan pesan untuk waktu tertentu
+const scheduled = scheduler.schedule(
+    '6281234567890@s.whatsapp.net',
+    { text: 'Selamat Ulang Tahun! 🎂' },
+    new Date('2024-12-25 09:00:00')
+)
 
-| Function | Description |
-|----------|-------------|
-| `parseJid()` | Parse JID dan extract info lengkap |
-| `getSenderPn()` | Get senderPn dari AuthenticationCreds |
-| `getCurrentSenderInfo()` | Get current sender info dari authState |
-| `isSelf()` | Check apakah JID adalah diri sendiri |
-| `plotJid()` | Plot JID (basic, tanpa LID mapping) |
-| `normalizePhoneToJid()` | Normalize nomor ke JID |
-| `extractPhoneNumber()` | Extract phone number dari JID |
-| `formatJidDisplay()` | Format JID untuk display |
-| `isSameUser()` | Compare dua JID |
-| `getJidVariants()` | Get semua variant JID dari nomor |
-| `constructJidWithDevice()` | Construct JID dengan device ID |
-| `getRemoteJidFromMessage()` | Get remoteJid dari message |
-| `createJidPlotter()` | Create plotter dengan LID mapping support |
+// Jadwalkan dengan delay (30 menit dari sekarang)
+scheduler.scheduleDelay(jid, { text: 'Reminder!' }, 30 * 60 * 1000)
+
+// Cancel scheduled message
+scheduler.cancel(scheduled.id)
+
+// Get all pending messages
+const pending = scheduler.getPending()
+
+// Stop scheduler
+scheduler.stop()
+```
 
 </details>
 
 <details>
-<summary><b>📢 Newsletter/Channel</b></summary>
+<summary><h3>📨 Bulk Messaging</h3></summary>
 
-| Function | Description |
-|----------|-------------|
-| `newsletterCreate()` | Buat channel baru |
-| `newsletterUpdateName()` | Update nama channel |
-| `newsletterUpdateDescription()` | Update deskripsi channel |
-| `newsletterUpdatePicture()` | Update foto channel |
-| `newsletterFollow()` | Follow channel |
-| `newsletterUnfollow()` | Unfollow channel |
-| `newsletterMute()` | Mute notifikasi channel |
-| `newsletterUnmute()` | Unmute notifikasi channel |
-| `newsletterReactMessage()` | React ke pesan channel |
-| `newsletterMetadata()` | Get metadata channel |
-| `newsletterAdminCount()` | Get jumlah admin |
-| `newsletterChangeOwner()` | Ganti owner channel |
-| `newsletterDemote()` | Demote admin channel |
-| `newsletterDelete()` | Hapus channel |
+Kirim pesan massal ke banyak kontak dengan rate limiting:
+
+```typescript
+import { createBulkSender, sendBulkMessages } from 'baileys-joss'
+
+// Method 1: Create bulk sender instance
+const bulkSender = createBulkSender(
+    (jid, content) => sock.sendMessage(jid, content),
+    {
+        delayBetweenMessages: 2000, // 2 detik delay
+        randomDelay: 1000, // Random 0-1 detik tambahan
+        maxRetries: 2,
+        onProgress: (progress) => {
+            console.log(`Progress: ${progress.sent}/${progress.total} (${progress.percentage}%)`)
+        },
+        onComplete: (results) => {
+            const success = results.filter(r => r.success).length
+            console.log(`Selesai: ${success}/${results.length} berhasil`)
+        }
+    }
+)
+
+// Kirim pesan yang sama ke banyak JID
+const jids = [
+    '6281234567890@s.whatsapp.net',
+    '6281234567891@s.whatsapp.net',
+    '6281234567892@s.whatsapp.net'
+]
+
+const results = await bulkSender.sendToMany(jids, { text: 'Hello everyone!' })
+
+// Kirim pesan berbeda ke JID berbeda
+const messages = [
+    { jid: '6281...@s.whatsapp.net', content: { text: 'Hi John!' } },
+    { jid: '6282...@s.whatsapp.net', content: { text: 'Hi Jane!' } }
+]
+await bulkSender.send(messages)
+
+// Method 2: Quick helper
+await sendBulkMessages(
+    (jid, content) => sock.sendMessage(jid, content),
+    jids,
+    { text: 'Broadcast message' }
+)
+```
 
 </details>
 
 <details>
-<summary><b>👥 Group Management</b></summary>
+<summary><h3>🔄 Auto Reply System</h3></summary>
 
-| Function | Description |
-|----------|-------------|
-| `groupCreate()` | Buat grup baru |
-| `groupUpdateSubject()` | Update nama grup |
-| `groupUpdateDescription()` | Update deskripsi grup |
-| `groupParticipantsUpdate()` | Add/remove/promote/demote member |
-| `groupSettingUpdate()` | Update pengaturan grup |
-| `groupMetadata()` | Get metadata grup |
-| `groupLeave()` | Keluar dari grup |
-| `groupInviteCode()` | Get kode invite grup |
-| `groupAcceptInvite()` | Join grup via invite code |
+Sistem balasan otomatis berdasarkan keyword/pattern:
+
+```typescript
+import { createAutoReply } from 'baileys-joss'
+
+// Buat auto-reply handler
+const autoReply = createAutoReply(
+    (jid, content, options) => sock.sendMessage(jid, content, options),
+    (jid, presence) => sock.sendPresenceUpdate(presence, jid),
+    {
+        simulateTyping: true,
+        typingDuration: 1500,
+        globalCooldown: 1000
+    }
+)
+
+// Tambah rule berdasarkan keywords
+autoReply.addRule({
+    keywords: ['harga', 'price', 'biaya'],
+    response: { text: 'Silakan cek katalog kami di example.com' },
+    cooldown: 60000, // 1 menit cooldown per user
+    quoted: true // Reply dengan quote
+})
+
+// Rule dengan regex pattern
+autoReply.addRule({
+    pattern: /^(hi|hello|halo|hay)/i,
+    response: { text: 'Hai! Ada yang bisa dibantu? 😊' },
+    privateOnly: true // Hanya di private chat
+})
+
+// Rule dengan dynamic response
+autoReply.addRule({
+    keywords: ['order'],
+    response: async (message, match) => {
+        const sender = message.key.remoteJid
+        return { text: `Terima kasih sudah order! ID: ${Date.now()}` }
+    }
+})
+
+// Rule untuk grup saja
+autoReply.addRule({
+    exactMatch: '/menu',
+    response: { text: 'Menu:\n1. Help\n2. Info\n3. Contact' },
+    groupsOnly: true
+})
+
+// Proses pesan masuk
+sock.ev.on('messages.upsert', async ({ messages }) => {
+    for (const msg of messages) {
+        if (!msg.key.fromMe) {
+            await autoReply.processMessage(msg)
+        }
+    }
+})
+```
 
 </details>
 
 <details>
-<summary><b>💬 Message Types</b></summary>
+<summary><h3>📇 Contact Card (vCard)</h3></summary>
 
-| Type | Description |
-|------|-------------|
-| `text` | Pesan teks biasa |
-| `image` | Kirim gambar |
-| `video` | Kirim video |
-| `audio` | Kirim audio |
-| `document` | Kirim dokumen |
-| `sticker` | Kirim sticker |
-| `location` | Kirim lokasi |
-| `contacts` | Kirim kontak |
-| `poll` | Buat polling |
-| `album` | Kirim album (multiple media) |
-| `react` | React ke pesan |
-| `edit` | Edit pesan |
-| `delete` | Hapus pesan |
+Kirim kartu kontak lengkap dengan detail:
 
-</details>
+```typescript
+import { 
+    createContactCard, 
+    createContactCards, 
+    quickContact,
+    generateVCard 
+} from 'baileys-joss'
 
----
+// Quick contact (simple)
+const simple = quickContact('John Doe', '+628123456789', {
+    organization: 'PT Example',
+    email: 'john@example.com'
+})
+await sock.sendMessage(jid, createContactCard(simple))
+
+// Full vCard with all details
+const fullContact = {
+    fullName: 'Dr. John Doe',
+    displayName: 'John D.',
+    organization: 'Hospital ABC',
+    title: 'Senior Doctor',
+    phones: [
+        { number: '+628123456789', type: 'CELL' },
+        { number: '+622112345678', type: 'WORK' }
+    ],
+    emails: [
+        { email: 'john@hospital.com', type: 'WORK' },
+        { email: 'john.personal@gmail.com', type: 'HOME' }
+    ],
+    urls: [
+        { url: 'https://linkedin.com/in/johndoe', type: 'WORK' }
+    ],
+    addresses: [{
+        street: 'Jl. Sudirman No. 123',
+        city: 'Jakarta',
+        state: 'DKI Jakarta',
+        postalCode: '12345',
+        country: 'Indonesia',
+        type: 'WORK'
+    }],
+    birthday: '1990-05-15',
+    note: 'Met at conference 2024'
+}
 
-## 🔄 Changelog
+await sock.sendMessage(jid, createContactCard(fullContact))
+
+// Send multiple contacts
+const contacts = [
+    quickContact('Alice', '+628111111111'),
+    quickContact('Bob', '+628222222222'),
+    quickContact('Charlie', '+628333333333')
+]
+await sock.sendMessage(jid, createContactCards(contacts))
+
+// Generate raw vCard string
+const vcardString = generateVCard(fullContact)
+console.log(vcardString)
+```
+
+</details>
+
+<details>
+<summary><h3>📺 Status/Story Posting</h3></summary>
+
+Posting status WhatsApp (foto, video, text):
+
+```typescript
+import { 
+    StatusHelper, 
+    STATUS_BROADCAST_JID,
+    STATUS_BACKGROUNDS,
+    STATUS_FONTS
+} from 'baileys-joss'
+
+const statusJid = STATUS_BROADCAST_JID // 'status@broadcast'
+
+// Post text status
+await sock.sendMessage(statusJid, StatusHelper.text(
+    'Hello World! 🌍',
+    STATUS_BACKGROUNDS.solid.green
+))
+
+// Post image status
+const imageBuffer = fs.readFileSync('./my-photo.jpg')
+await sock.sendMessage(statusJid, StatusHelper.image(
+    imageBuffer,
+    'Beautiful day! ☀️'
+))
+
+// Post video status
+const videoBuffer = fs.readFileSync('./my-video.mp4')
+await sock.sendMessage(statusJid, StatusHelper.video(
+    videoBuffer,
+    'Check this out! 🎬'
+))
+
+// Post GIF status
+await sock.sendMessage(statusJid, StatusHelper.gif(
+    gifBuffer,
+    'Animated! 🎭'
+))
+
+// Post voice note status
+await sock.sendMessage(statusJid, StatusHelper.voiceNote(audioBuffer))
+
+// Custom text status with font
+import { createTextStatus } from 'baileys-joss'
+
+await sock.sendMessage(statusJid, createTextStatus({
+    text: 'Custom styled status!',
+    backgroundColor: STATUS_BACKGROUNDS.solid.purple,
+    font: STATUS_FONTS.DANCING,
+    textColor: '#FFFFFF'
+}))
+```
+
+</details>
+
+<details>
+<summary><h3>🎤 Voice Note Helper</h3></summary>
+
+Rekam dan kirim voice note dengan PTT mode:
+
+```typescript
+import { 
+    createVoiceNote, 
+    createAudioMessage,
+    VoiceNoteHelper 
+} from 'baileys-joss'
+
+// Simple voice note from buffer
+const voiceNote = await VoiceNoteHelper.fromBuffer(audioBuffer, 15) // 15 seconds
+await sock.sendMessage(jid, voiceNote)
+
+// Voice note from file
+const vnFromFile = await VoiceNoteHelper.fromFile('./recording.mp3')
+await sock.sendMessage(jid, vnFromFile)
+
+// Regular audio (not PTT)
+const audio = await VoiceNoteHelper.audioFromBuffer(audioBuffer)
+await sock.sendMessage(jid, audio)
+
+// Check if FFmpeg is available (for conversions)
+const hasFFmpeg = await VoiceNoteHelper.checkFFmpeg()
+
+// Convert audio to Opus (WhatsApp format)
+const opusBuffer = await VoiceNoteHelper.toOpus(mp3Buffer)
+
+// Get audio duration
+const duration = await VoiceNoteHelper.getDuration(audioBuffer)
+console.log(`Audio duration: ${duration} seconds`)
+
+// Full control with createVoiceNote
+const customVN = await createVoiceNote(audioBuffer, {
+    seconds: 30,
+    sampleRate: 48000,
+    channels: 1
+})
+await sock.sendMessage(jid, customVN)
+```
+
+</details>
+
+<details>
+<summary><h3>📋 Message Templates</h3></summary>
+
+Template pesan siap pakai untuk berbagai keperluan:
+
+```typescript
+import { createTemplateManager, renderTemplate, PRESET_TEMPLATES } from 'baileys-joss'
+
+// Create manager with preset templates
+const templates = createTemplateManager(true)
+
+// Render preset template
+const orderConfirmation = templates.render('order_confirmation', {
+    orderId: 'ORD-12345',
+    customerName: 'John Doe',
+    orderDate: '2024-01-15',
+    items: '1x Product A\n2x Product B',
+    total: '150,000'
+})
+
+await sock.sendMessage(jid, { text: orderConfirmation })
+
+// Create custom template
+templates.create({
+    name: 'Welcome Message',
+    content: `Halo {{name}}! 👋
+
+Selamat datang di {{company}}!
+
+Berikut layanan kami:
+{{services}}
+
+Contact: {{phone:021-12345678}}`,
+    category: 'greeting'
+})
+
+// Render custom template
+const welcome = templates.render('welcome_message', {
+    name: 'Budi',
+    company: 'PT Example',
+    services: '- Layanan A\n- Layanan B\n- Layanan C'
+})
+
+// Quick template rendering (tanpa manager)
+const quick = renderTemplate(
+    'Hi {{name}}, your order #{{orderId}} is {{status:processing}}',
+    { name: 'Alice', orderId: '123' }
+)
+
+// List available templates
+const allTemplates = templates.getAll()
+const invoiceTemplates = templates.getByCategory('invoice')
+
+// Export/Import templates
+const exportJson = templates.export()
+templates.import(exportJson, true) // true = overwrite existing
+```
+
+</details>
+
+<details>
+<summary><h3>📡 Broadcast Manager</h3></summary>
+
+Kelola dan kirim ke broadcast list:
+
+```typescript
+import { createBroadcastManager } from 'baileys-joss'
+
+const broadcast = createBroadcastManager(
+    (jid, content) => sock.sendMessage(jid, content)
+)
+
+// Create broadcast list
+const customerList = broadcast.create({
+    name: 'VIP Customers',
+    description: 'Premium customers for promo',
+    recipients: [
+        '6281234567890@s.whatsapp.net',
+        '6281234567891@s.whatsapp.net'
+    ]
+})
+
+// Add more recipients
+broadcast.addRecipients(customerList.id, [
+    '6281234567892@s.whatsapp.net'
+])
+
+// Send to broadcast list
+const result = await broadcast.broadcast(
+    customerList.id,
+    { text: '🎉 Special promo for VIP customers!' },
+    {
+        delay: 2000,
+        onProgress: (sent, total, jid) => {
+            console.log(`Sending ${sent}/${total}: ${jid}`)
+        }
+    }
+)
+
+console.log(`Sent: ${result.sent}, Failed: ${result.failed}`)
+
+// Get statistics
+const stats = broadcast.getStats()
+console.log(`Total lists: ${stats.totalLists}, Recipients: ${stats.totalRecipients}`)
+
+// Export/Import lists
+const json = broadcast.export()
+broadcast.import(json)
+```
+
+</details>
+
+<details>
+<summary><h3>⌨️ Typing Indicator</h3></summary>
+
+Simulasi sedang mengetik:
+
+```typescript
+import { createTypingIndicator } from 'baileys-joss'
+
+const typing = createTypingIndicator(
+    (jid, presence) => sock.sendPresenceUpdate(presence, jid)
+)
+
+// Start typing
+await typing.startTyping(jid, { 
+    duration: 5000,  // Auto pause after 5 seconds
+    autoPause: true 
+})
+
+// Start recording (for voice notes)
+await typing.startRecording(jid, { duration: 3000 })
+
+// Stop typing
+await typing.stopTyping(jid)
+
+// Simulate typing then send
+await typing.simulateTyping(jid, 2000, async () => {
+    return sock.sendMessage(jid, { text: 'Hello!' })
+})
+
+// Stop all typing indicators
+await typing.stopAll()
+```
+
+</details>
+
+<details>
+<summary><h3>✅ Read Receipt Control</h3></summary>
+
+Kontrol centang biru:
+
+```typescript
+import { createReadReceiptController } from 'baileys-joss'
+
+const readReceipts = createReadReceiptController(
+    (jid, participant, messageIds) => sock.readMessages([{ remoteJid: jid, id: messageIds[0] }]),
+    {
+        enabled: true,
+        readDelay: 1000, // 1 second delay
+        excludeJids: ['blocked@s.whatsapp.net']
+    }
+)
+
+// Toggle read receipts
+readReceipts.disable() // Stop sending read receipts
+readReceipts.enable()  // Resume
+
+// Check status
+console.log(readReceipts.isEnabled())
+
+// Manual read (respects config)
+await readReceipts.markRead(jid, participant, ['messageId123'])
+
+// Force read (ignores config)
+await readReceipts.forceMarkRead(jid, participant, ['messageId123'])
+
+// Update config
+readReceipts.setConfig({
+    enabled: true,
+    readDelay: 2000
+})
+```
+
+</details>
+
+<details>
+<summary><h3>🔍 Message Search</h3></summary>
+
+Cari pesan dalam chat:
+
+```typescript
+import { createMessageSearch, searchMessages } from 'baileys-joss'
+
+// Create search manager
+const search = createMessageSearch()
+
+// Add messages to index
+search.addMessages(chatMessages)
+
+// Search by text
+const results = search.search('harga produk', {
+    caseSensitive: false,
+    limit: 20,
+    messageTypes: ['text', 'image'], // Include captions
+    fromDate: new Date('2024-01-01')
+})
+
+for (const result of results) {
+    console.log(`Found: "${result.matchedText}"`)
+    console.log(`Score: ${result.relevanceScore}`)
+    console.log(`Message ID: ${result.message.key.id}`)
+}
+
+// Search with regex
+const regexResults = search.searchRegex(/order\s*#?\d+/i)
+
+// Get messages by type
+const images = search.getByType('image')
+const videos = search.getByType('video')
+
+// Get messages by sender
+const fromSender = search.getBySender('6281234567890@s.whatsapp.net')
+
+// Quick search (without manager)
+const quickResults = searchMessages(messages, 'keyword', {
+    jid: specificChatJid,
+    fromMe: false
+})
+```
+
+</details>
+
+<details>
+<summary><h3>📊 Chat Analytics</h3></summary>
+
+Statistik dan analitik chat:
+
+```typescript
+import { createChatAnalytics } from 'baileys-joss'
+
+const analytics = createChatAnalytics()
+
+// Add messages for analysis
+analytics.addMessages(allMessages)
+
+// Get stats for specific chat
+const chatStats = analytics.getChatStats('6281234567890@s.whatsapp.net')
+
+console.log(`Total messages: ${chatStats.totalMessages}`)
+console.log(`From me: ${chatStats.messagesFromMe}`)
+console.log(`Media count: ${chatStats.mediaCount}`)
+console.log(`Links shared: ${chatStats.linkCount}`)
+console.log(`Emojis used: ${chatStats.emojiCount}`)
+console.log(`Most active hour: ${chatStats.mostActiveHour}:00`)
+console.log(`Most active day: ${chatStats.mostActiveDay}`)
+console.log(`Avg messages/day: ${chatStats.averageMessagesPerDay}`)
+
+// Message breakdown by type
+console.log('Messages by type:', chatStats.messagesByType)
+// { text: 150, image: 45, video: 12, audio: 8, ... }
+
+// Global stats across all chats
+const globalStats = analytics.getGlobalStats()
+console.log(`Total chats: ${globalStats.totalChats}`)
+console.log(`Total messages: ${globalStats.totalMessages}`)
+console.log(`Most active chat: ${globalStats.mostActiveChat?.jid}`)
+
+// Activity analysis
+const hourlyActivity = analytics.getActivityByHour(jid) // Array[24]
+const dailyActivity = analytics.getActivityByDay(jid) // { Sunday: 10, Monday: 25, ... }
+
+// Top participants in group
+const topParticipants = analytics.getTopParticipants(groupJid, 5)
+for (const p of topParticipants) {
+    console.log(`${p.participant}: ${p.count} messages`)
+}
+```
+
+</details>
+
+<details>
+<summary><h3>💾 Chat Export</h3></summary>
+
+Export chat ke JSON, HTML, TXT, atau CSV:
+
+```typescript
+import { createChatExporter, exportChat } from 'baileys-joss'
+
+const exporter = createChatExporter()
+
+// Add messages
+exporter.addMessages(jid, chatMessages)
+
+// Export to JSON
+const jsonExport = exporter.export(jid, {
+    format: 'json',
+    includeMediaInfo: true,
+    includeMetadata: true
+})
+
+fs.writeFileSync(jsonExport.filename, jsonExport.content)
+
+// Export to HTML (readable format)
+const htmlExport = exporter.export(jid, {
+    format: 'html',
+    title: 'Chat dengan John',
+    dateFormat: 'YYYY-MM-DD HH:mm'
+})
+
+fs.writeFileSync(htmlExport.filename, htmlExport.content)
+
+// Export to TXT (simple text)
+const txtExport = exporter.export(jid, {
+    format: 'txt',
+    dateRange: {
+        start: new Date('2024-01-01'),
+        end: new Date('2024-12-31')
+    }
+})
+
+// Export to CSV (for spreadsheet)
+const csvExport = exporter.export(jid, {
+    format: 'csv',
+    includeMetadata: true
+})
+
+// Quick export (without manager)
+const result = exportChat(messages, jid, { format: 'json' })
+console.log(`Exported ${result.messageCount} messages`)
+
+// Export all chats
+const allExports = exporter.exportAll({ format: 'json' })
+```
+
+</details>
+
+<details>
+<summary><h3>🎮 Mini Games (UNTESTED ⚠️)</h3></summary>
+
+Game sederhana untuk chat interaktif:
+
+```typescript
+import { 
+    MiniGamesManager,
+    createTicTacToeGame,
+    createQuiz 
+} from 'baileys-joss'
+
+// Create games manager
+const games = new MiniGamesManager()
+
+// 🎯 Guess Number Game
+const guessSession = games.startGuessNumber('6281234567890@s.whatsapp.net', {
+    minNumber: 1,
+    maxNumber: 100,
+    maxAttempts: 7
+})
+
+// Handle guess
+const result = games.handleGuess(guessSession.id, 50)
+if (result.correct) {
+    await sock.sendMessage(jid, { text: `🎉 Correct! The number was ${result.answer}` })
+} else {
+    await sock.sendMessage(jid, { text: `${result.hint} (${result.remaining} attempts left)` })
+}
+
+// 🧠 Quiz Game
+const quizSession = games.startQuiz(jid, {
+    questions: [
+        {
+            question: 'Apa ibukota Indonesia?',
+            options: ['Jakarta', 'Bandung', 'Surabaya', 'Medan'],
+            correctIndex: 0,
+            explanation: 'Jakarta adalah ibukota Indonesia sejak 1945'
+        }
+    ],
+    category: 'geography'
+})
+await sock.sendMessage(jid, { 
+    text: `📝 Quiz:\n${quizSession.data.currentQuestion}\n\n${quizSession.data.options.map((o, i) => `${i+1}. ${o}`).join('\n')}` 
+})
+
+// ❌⭕ TicTacToe Game  
+const tttSession = games.startTicTacToe(jid, player1Jid, player2Jid)
+const moveResult = games.handleMove(tttSession.id, player1Jid, 4) // Center position
+
+await sock.sendMessage(jid, { 
+    text: `${games.renderBoard(tttSession)}\n\n${moveResult.message}` 
+})
+
+// 🎲 Quick Games
+const dice = games.rollDice() // { value: 1-6, emoji: '🎲' }
+const coin = games.flipCoin() // { result: 'heads'|'tails', emoji: '🪙' }
+const rps = games.playRockPaperScissors('rock', 'scissors') // { winner: 'player1', ... }
+
+// 🏆 Leaderboard
+const leaderboard = games.getLeaderboard(10)
+```
+
+</details>
+
+<details>
+<summary><h3>🔍 Content Detector (UNTESTED ⚠️)</h3></summary>
+
+Deteksi otomatis berbagai jenis konten dalam pesan:
+
+```typescript
+import { 
+    ContentDetector, 
+    ContentFilter,
+    hasLinks,
+    hasPhoneNumbers,
+    hasEmails,
+    hasMediaContent 
+} from 'baileys-joss'
+
+// Create detector
+const detector = new ContentDetector()
+
+// Full analysis
+const result = detector.analyze(message)
+console.log('Has media:', result.hasMedia)
+console.log('Media type:', result.mediaType)
+console.log('Links found:', result.links)
+console.log('Phone numbers:', result.phoneNumbers)
+console.log('Emails:', result.emails)
+console.log('Mentions:', result.mentions)
+console.log('Hashtags:', result.hashtags)
+console.log('Word count:', result.wordCount)
+
+// Quick checks
+if (hasLinks(message)) {
+    console.log('Message contains links!')
+}
+if (hasPhoneNumbers(message)) {
+    console.log('Message contains phone numbers!')
+}
+if (hasMediaContent(message)) {
+    console.log('Message has media attachment!')
+}
+
+// Content filtering
+const filter = new ContentFilter({
+    blockLinks: true,
+    blockedDomains: ['spam.com', 'malware.xyz'],
+    blockPhoneNumbers: false,
+    sensitiveKeywords: ['spam', 'promo', 'click here'],
+    maxMessageLength: 1000
+})
+
+const filterResult = filter.check(message)
+if (!filterResult.allowed) {
+    await sock.sendMessage(jid, { 
+        text: `⚠️ Message blocked: ${filterResult.blockedReason}` 
+    })
+}
+```
+
+</details>
+
+<details>
+<summary><h3>🛡️ Anti-Spam System (UNTESTED ⚠️)</h3></summary>
+
+Sistem untuk mendeteksi dan mencegah spam:
+
+```typescript
+import { AntiSpamManager } from 'baileys-joss'
+
+// Create anti-spam manager
+const antispam = new AntiSpamManager({
+    maxMessagesPerMinute: 15,
+    maxDuplicates: 3,
+    duplicateWindow: 60000, // 1 minute
+    minMessageDelay: 500,
+    whitelist: ['admin@s.whatsapp.net'],
+    onSpamDetected: async (jid, message, result) => {
+        console.log(`Spam detected from ${jid}: ${result.reason}`)
+        if (result.action === 'mute') {
+            await sock.sendMessage(jid, { text: '⚠️ You are muted for spamming!' })
+        }
+    }
+})
+
+// Add custom spam pattern
+antispam.addRule({
+    id: 'promo_spam',
+    name: 'Promotional Spam',
+    type: 'pattern',
+    enabled: true,
+    config: { patterns: [/FREE\s+\d+\s+TOKEN/i, /CLICK\s+HERE.*WIN/i] },
+    action: 'delete'
+})
+
+// Check incoming messages
+sock.ev.on('messages.upsert', async ({ messages }) => {
+    for (const msg of messages) {
+        const result = await antispam.checkMessage(msg)
+        
+        if (result.isSpam) {
+            console.log(`🛡️ Spam blocked! Score: ${result.score}, Reason: ${result.reason}`)
+            
+            // Handle based on action
+            if (result.action === 'delete') {
+                await sock.sendMessage(msg.key.remoteJid, { delete: msg.key })
+            } else if (result.action === 'warn') {
+                await sock.sendMessage(msg.key.remoteJid, { 
+                    text: `⚠️ Warning: ${result.reason}` 
+                })
+            }
+            continue
+        }
+        
+        // Process non-spam message...
+    }
+})
+
+// Whitelist trusted users
+antispam.whitelist('trusteduser@s.whatsapp.net')
+
+// Mute spammer temporarily
+antispam.muteUser('spammer@s.whatsapp.net', 3600) // 1 hour
+
+// Ban repeat offender
+antispam.banUser('baduser@s.whatsapp.net')
+
+// Get spam statistics
+const stats = antispam.getStats()
+console.log('Total spam blocked:', stats.totalBlocked)
+```
+
+</details>
+
+<details>
+<summary><h3>🔗 Link Scanner (UNTESTED ⚠️)</h3></summary>
+
+Scan dan validasi URL untuk keamanan:
+
+```typescript
+import { LinkScanner, scanUrls, isUrlSafe } from 'baileys-joss'
+
+// Create scanner
+const scanner = new LinkScanner({
+    followRedirects: true,
+    maxRedirects: 5,
+    timeout: 5000,
+    enablePhishingDetection: true
+})
+
+// Scan single URL
+const result = await scanner.scanUrl('https://suspicious-link.xyz/login')
+console.log('Safe:', result.safe)
+console.log('Risk level:', result.riskLevel) // 'safe' | 'low' | 'medium' | 'high' | 'critical'
+console.log('Threats:', result.threats)
+console.log('Details:', result.details)
+
+// Scan all URLs in a message
+const messageResults = await scanner.scanMessage(message)
+for (const urlResult of messageResults) {
+    if (!urlResult.safe) {
+        await sock.sendMessage(jid, { 
+            text: `⚠️ Warning! Suspicious link detected:\n${urlResult.url}\n\nRisk: ${urlResult.riskLevel}\nThreats: ${urlResult.threats.join(', ')}` 
+        })
+    }
+}
+
+// Quick safety check
+const isSafe = await scanner.isUrlSafe('https://example.com')
+
+// Add custom patterns
+scanner.addPhishingPattern(/banking.*verify.*account/i)
+scanner.addTrustedDomain('mytrusted.com')
+scanner.addMaliciousDomain('known-scam.xyz')
+
+// Auto-scan in message handler
+sock.ev.on('messages.upsert', async ({ messages }) => {
+    for (const msg of messages) {
+        const scanResults = await scanner.scanMessage(msg)
+        const dangerous = scanResults.filter(r => r.riskLevel === 'high' || r.riskLevel === 'critical')
+        
+        if (dangerous.length > 0) {
+            await sock.sendMessage(msg.key.remoteJid, { 
+                text: `🚨 Dangerous link(s) detected! ${dangerous.length} threat(s) found.`
+            }, { quoted: msg })
+        }
+    }
+})
+```
+
+</details>
+
+<details>
+<summary><h3>📝 Activity Logger (UNTESTED ⚠️)</h3></summary>
+
+Logging aktivitas untuk audit trail:
+
+```typescript
+import { ActivityLogger } from 'baileys-joss'
+
+// Create logger
+const logger = new ActivityLogger({
+    fileLogging: true,
+    logFilePath: './logs/bot-activity.log',
+    maxMemoryEntries: 1000,
+    maxFileSize: 10 * 1024 * 1024, // 10MB
+    minLevel: 'info',
+    categories: ['message', 'user', 'group', 'bot'],
+    onLog: (entry) => {
+        if (entry.level === 'error') {
+            // Send alert to admin
+            console.error(`[ALERT] ${entry.action}: ${entry.details.message}`)
+        }
+    }
+})
+
+// Log message activity
+logger.logMessage(message, 'received', {
+    processed: true,
+    responseTime: 150
+})
+
+// Log user action
+logger.logUserAction('6281234567890@s.whatsapp.net', 'command_executed', {
+    command: '/help',
+    success: true
+})
+
+// Log group action
+logger.logGroupAction('groupjid@g.us', 'member_added', {
+    addedBy: 'admin@s.whatsapp.net',
+    newMember: 'newuser@s.whatsapp.net'
+})
+
+// Log custom activity
+logger.log({
+    level: 'info',
+    category: 'bot',
+    action: 'scheduled_task',
+    actor: 'system',
+    details: { task: 'daily_backup', status: 'completed' }
+})
+
+// Query logs
+const recentErrors = logger.query({
+    level: 'error',
+    fromDate: new Date(Date.now() - 24 * 60 * 60 * 1000), // Last 24 hours
+    limit: 50
+})
+
+// Get statistics
+const stats = logger.getStats()
+console.log('Total entries:', stats.totalEntries)
+console.log('By level:', stats.byLevel)
+console.log('Top actors:', stats.topActors)
+
+// Export logs
+const jsonLogs = logger.export('json')
+const csvLogs = logger.export('csv')
+```
+
+</details>
+
+<details>
+<summary><h3>🎭 Meme Generator (UNTESTED ⚠️)</h3></summary>
+
+Generate meme sederhana dengan text overlay:
+
+```typescript
+import { 
+    MemeGenerator, 
+    MEME_TEMPLATES,
+    drakeMeme,
+    expandingBrainMeme,
+    thisIsFineMeme 
+} from 'baileys-joss'
+
+// Create generator
+const meme = new MemeGenerator()
+
+// List available templates
+const templates = meme.getTemplates()
+console.log('Available templates:', templates.map(t => t.name))
+
+// Generate Drake meme (quick helper)
+const drake = drakeMeme(
+    'Debugging code manually',      // Rejected
+    'Using console.log everywhere'  // Approved
+)
+await sock.sendMessage(jid, { text: drake.htmlContent })
+
+// Generate Expanding Brain meme
+const brain = expandingBrainMeme([
+    'Using var',
+    'Using let',
+    'Using const',
+    'Using TypeScript'
+])
+await sock.sendMessage(jid, { text: brain.htmlContent })
+
+// Generate "This is Fine" meme
+const fine = thisIsFineMeme('Production is on fire but it\'s fine')
+await sock.sendMessage(jid, { text: fine.htmlContent })
+
+// Custom meme with template
+const custom = meme.generateTextMeme({
+    template: 'distracted',
+    texts: {
+        boyfriend: 'Me',
+        girlfriend: 'My deadlines',
+        other: 'New side project'
+    },
+    fontSize: 24,
+    fontColor: '#ffffff'
+})
+
+// Generate SVG meme (for advanced use)
+const svgMeme = meme.generateSvgMeme({
+    template: 'two_buttons',
+    texts: {
+        button1: 'Sleep early',
+        button2: 'One more episode'
+    }
+})
+
+// Send as formatted text meme
+await sock.sendMessage(jid, { 
+    text: `🎭 *MEME*\n\n${custom.htmlContent}` 
+})
+```
+
+</details>
+
+<details>
+<summary><h3>🍅 Pomodoro Timer (UNTESTED ⚠️)</h3></summary>
+
+Timer produktivitas dengan teknik Pomodoro:
+
+```typescript
+import { PomodoroManager, DEFAULT_POMODORO_CONFIG } from 'baileys-joss'
+
+// Create pomodoro manager
+const pomodoro = new PomodoroManager()
+
+// Register event handler
+pomodoro.onEvent(async (event) => {
+    const jid = event.session.jid
+    
+    switch (event.type) {
+        case 'work_start':
+            await sock.sendMessage(jid, { 
+                text: `🍅 *WORK SESSION STARTED*\n\n⏱️ Duration: 25 minutes\n🎯 Session: ${event.session.currentSession}/${event.session.totalSessions}\n\n💪 Stay focused!` 
+            })
+            break
+        case 'work_end':
+            await sock.sendMessage(jid, { 
+                text: `✅ *WORK SESSION COMPLETE!*\n\n🎉 Great job! Time for a break.\n\nType /break to start break timer.` 
+            })
+            break
+        case 'break_start':
+            await sock.sendMessage(jid, { 
+                text: `☕ *BREAK TIME*\n\n⏱️ Duration: 5 minutes\n\n🧘 Relax and recharge!` 
+            })
+            break
+        case 'break_end':
+            await sock.sendMessage(jid, { 
+                text: `⏰ *BREAK OVER!*\n\nReady for next session?\nType /work to continue.` 
+            })
+            break
+    }
+})
+
+// Start work session
+const session = pomodoro.start('6281234567890@s.whatsapp.net', {
+    workDuration: 25,      // 25 minutes
+    shortBreakDuration: 5, // 5 minutes
+    longBreakDuration: 15, // 15 minutes
+    sessionsBeforeLongBreak: 4,
+    autoStartBreaks: true
+})
+
+// Pause/Resume
+pomodoro.pause(jid)
+pomodoro.resume(jid)
+
+// Start break manually
+pomodoro.startBreak(jid)
+
+// Get current status
+const status = pomodoro.status(jid)
+console.log('Status:', status.status) // 'work' | 'short_break' | 'long_break' | 'paused'
+console.log('Time remaining:', status.remainingTime)
+console.log('Current session:', status.currentSession)
+
+// Stop and reset
+pomodoro.stop(jid)
+
+// Get statistics
+const stats = pomodoro.stats(jid)
+console.log('Total work sessions:', stats.totalWorkSessions)
+console.log('Total work minutes:', stats.totalWorkMinutes)
+console.log('Current streak:', stats.currentStreak)
+```
+
+</details>
+
+<details>
+<summary><h3>💬 Quote Generator (UNTESTED ⚠️)</h3></summary>
+
+Random quotes dan quotes harian:
+
+```typescript
+import { 
+    QuoteManager,
+    getRandomQuote,
+    getQuoteOfTheDay,
+    getMotivationalQuote,
+    getIslamicQuote,
+    getFunnyQuote,
+    quoteCommand,
+    QUOTES 
+} from 'baileys-joss'
+
+// Quick helpers
+const random = getRandomQuote()
+await sock.sendMessage(jid, { 
+    text: `💬 *Quote*\n\n"${random.text}"\n\n— ${random.author}` 
+})
+
+// Quote of the day (same quote all day)
+const qotd = getQuoteOfTheDay()
+await sock.sendMessage(jid, { 
+    text: `📅 *Quote of the Day*\n\n"${qotd.quote.text}"\n\n— ${qotd.quote.author}` 
+})
+
+// Category-specific quotes
+const motivational = getMotivationalQuote()
+const islamic = getIslamicQuote()
+const funny = getFunnyQuote()
+
+// Using QuoteManager for more control
+const quoteManager = new QuoteManager()
+
+// Get quote by category
+const loveQuote = quoteManager.getByCategory('love')
+const wisdomQuote = quoteManager.getByCategory('wisdom')
+
+// Get quote by language
+const indonesianQuote = quoteManager.getByLanguage('id')
+const englishQuote = quoteManager.getByLanguage('en')
+
+// Search quotes
+const searchResults = quoteManager.search('success')
+
+// Add custom quote
+quoteManager.addQuote({
+    id: 'custom1',
+    text: 'My custom inspirational quote',
+    author: 'Me',
+    category: 'inspirational',
+    language: 'en'
+})
+
+// Parse command (for bot integration)
+// Supported: /quote, /quote motivational, /quote islamic, /quote funny
+const commandResult = quoteCommand('/quote motivational')
+await sock.sendMessage(jid, { text: commandResult })
+
+// Send random quote with formatting
+const formatted = quoteManager.format(getRandomQuote(), {
+    style: 'fancy', // 'simple' | 'fancy' | 'minimal'
+    includeCategory: true
+})
+await sock.sendMessage(jid, { text: formatted })
+```
+
+</details>
+
+<details>
+<summary><h3>🌤️ Weather Bot (UNTESTED ⚠️)</h3></summary>
+
+Informasi cuaca dengan integrasi OpenWeatherMap:
+
+```typescript
+import { 
+    WeatherBot, 
+    getWeather, 
+    getSimpleWeather,
+    weatherCommand 
+} from 'baileys-joss'
+
+// Create weather bot (with API key for full features)
+const weather = new WeatherBot({
+    apiKey: 'YOUR_OPENWEATHERMAP_API_KEY', // Optional: enables API mode
+    units: 'metric', // 'metric' | 'imperial'
+    language: 'id',
+    defaultCity: 'Jakarta'
+})
+
+// Get weather for a city
+const data = await weather.getWeather('Jakarta')
+await sock.sendMessage(jid, { 
+    text: `🌤️ *Weather in ${data.city}, ${data.country}*\n\n🌡️ Temperature: ${data.temperature}°C\n🤒 Feels like: ${data.feelsLike}°C\n💧 Humidity: ${data.humidity}%\n💨 Wind: ${data.windSpeed} m/s\n☁️ Condition: ${data.description}\n\n🌅 Sunrise: ${new Date(data.sunrise * 1000).toLocaleTimeString()}\n🌇 Sunset: ${new Date(data.sunset * 1000).toLocaleTimeString()}` 
+})
+
+// Quick helper (uses sample data if no API key)
+const simpleWeather = await getSimpleWeather('Tokyo')
+await sock.sendMessage(jid, { text: simpleWeather })
+
+// Get 5-day forecast
+const forecast = await weather.getForecast('Singapore')
+let forecastText = `📅 *5-Day Forecast for ${forecast.city}*\n\n`
+for (const day of forecast.forecasts.slice(0, 5)) {
+    forecastText += `${day.date}: ${day.temperature}°C, ${day.description}\n`
+}
+await sock.sendMessage(jid, { text: forecastText })
+
+// Weather alerts
+const alerts = await weather.getAlerts('Miami')
+if (alerts.length > 0) {
+    for (const alert of alerts) {
+        await sock.sendMessage(jid, { 
+            text: `⚠️ *Weather Alert*\n\n${alert.event}\n\nSeverity: ${alert.severity}\n${alert.description}` 
+        })
+    }
+}
+
+// Parse weather command (for bot integration)
+// Supported: /weather Jakarta, /cuaca Bandung
+const result = await weatherCommand('/weather Singapore', weather)
+await sock.sendMessage(jid, { text: result })
+
+// Format with emoji
+const formatted = weather.formatWeather(data, {
+    includeEmoji: true,
+    includeDetails: true,
+    language: 'id'
+})
+await sock.sendMessage(jid, { text: formatted })
+```
+
+</details>
+
+<details>
+<summary><h3>🔗 QR Code Generator</h3></summary>
+
+Generate QR code custom untuk pairing:
+
+```typescript
+import { 
+    createQRGenerator, 
+    QRHelper,
+    createQRHandler,
+    createWhatsAppQR 
+} from 'baileys-joss'
+
+// Quick QR generation
+const terminalQR = await QRHelper.terminal(pairingCode)
+console.log(terminalQR)
+
+// Generate SVG QR
+const svgQR = await QRHelper.svg(pairingCode, {
+    size: 300,
+    foregroundColor: '#128C7E', // WhatsApp green
+    backgroundColor: '#FFFFFF'
+})
+
+// Generate base64 QR (for web)
+const base64QR = await QRHelper.base64(pairingCode)
+
+// Generate PNG buffer
+const pngBuffer = await QRHelper.buffer(pairingCode)
+fs.writeFileSync('qr.png', pngBuffer)
+
+// Custom generator
+const generator = createQRGenerator({
+    size: 256,
+    errorCorrectionLevel: 'H',
+    foregroundColor: '#000000',
+    margin: 4
+})
+
+const qr = await generator.generate(data)
+
+// WhatsApp-styled QR
+const waQR = await createWhatsAppQR(pairingCode)
+
+// Use as QR event handler
+const sock = makeWASocket({
+    // ...
+    printQRInTerminal: false
+})
+
+sock.ev.on('connection.update', async ({ qr }) => {
+    if (qr) {
+        const qrHandler = createQRHandler({
+            maxAttempts: 5,
+            onQR: (rendered, raw, attempt) => {
+                console.log(`\nScan QR (${attempt}/5):\n`)
+                console.log(rendered)
+            }
+        })
+        await qrHandler(qr)
+    }
+})
+```
+
+</details>
+
+<details>
+<summary><h3>📁 Media Downloader</h3></summary>
+
+Download semua media dari chat:
+
+```typescript
+import { createMediaDownloader, downloadAllMedia } from 'baileys-joss'
+
+const downloader = createMediaDownloader(
+    async (key) => store.loadMessage(key.remoteJid, key.id)
+)
+
+// Download all media from chat
+const summary = await downloader.downloadFromChat(
+    '6281234567890@s.whatsapp.net',
+    chatMessages,
+    {
+        outputDir: './downloads/john-doe',
+        types: ['image', 'video', 'document'], // or ['all']
+        createSubfolders: true, // images/, videos/, etc.
+        skipExisting: true,
+        maxFileSize: 50 * 1024 * 1024, // 50MB limit
+        delay: 500, // Delay between downloads
+        onProgress: (current, total, filename) => {
+            console.log(`Downloading ${current}/${total}: ${filename}`)
+        },
+        onError: (msg, error) => {
+            console.log(`Failed: ${error.message}`)
+        }
+    }
+)
+
+console.log(`Downloaded: ${summary.successful}/${summary.total}`)
+console.log(`Total size: ${(summary.totalSize / 1024 / 1024).toFixed(2)} MB`)
+console.log(`Failed: ${summary.failed}`)
+
+// Download single media
+const singleResult = await downloader.downloadSingle(
+    mediaMessage,
+    './downloads',
+    { filenameTemplate: '{type}_{date}_{id}{ext}' }
+)
+
+// Quick download all (without manager)
+await downloadAllMedia(messages, './downloads/all-media', {
+    types: ['image'],
+    onProgress: (curr, total) => console.log(`${curr}/${total}`)
+})
+```
+
+</details>
+
+---
+
+## 📋 API Reference
+
+<details>
+<summary><b>🖱️ Interactive Messages</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `generateInteractiveButtonMessage()` | Buat button message dengan media header |
+| `generateInteractiveListMessage()` | Buat list message dengan sections |
+| `generateTemplateMessage()` | Buat template message (Quick Reply, URL, Call) |
+| `generateNativeFlowMessage()` | Buat native flow message (format terbaru) |
+| `generateCopyCodeButton()` | Button untuk copy code |
+| `generateUrlButtonMessage()` | Button dengan URL |
+| `generateQuickReplyButtons()` | Quick reply buttons |
+| `generateCombinedButtons()` | Gabungan berbagai jenis button |
+
+</details>
+
+<details>
+<summary><b>📍 JID Plotting</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `parseJid()` | Parse JID dan extract info lengkap |
+| `getSenderPn()` | Get senderPn dari AuthenticationCreds |
+| `getCurrentSenderInfo()` | Get current sender info dari authState |
+| `isSelf()` | Check apakah JID adalah diri sendiri |
+| `plotJid()` | Plot JID (basic, tanpa LID mapping) |
+| `normalizePhoneToJid()` | Normalize nomor ke JID |
+| `extractPhoneNumber()` | Extract phone number dari JID |
+| `formatJidDisplay()` | Format JID untuk display |
+| `isSameUser()` | Compare dua JID |
+| `getJidVariants()` | Get semua variant JID dari nomor |
+| `constructJidWithDevice()` | Construct JID dengan device ID |
+| `getRemoteJidFromMessage()` | Get remoteJid dari message |
+| `createJidPlotter()` | Create plotter dengan LID mapping support |
+
+</details>
+
+<details>
+<summary><b>📢 Newsletter/Channel</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `newsletterCreate()` | Buat channel baru |
+| `newsletterUpdateName()` | Update nama channel |
+| `newsletterUpdateDescription()` | Update deskripsi channel |
+| `newsletterUpdatePicture()` | Update foto channel |
+| `newsletterFollow()` | Follow channel |
+| `newsletterUnfollow()` | Unfollow channel |
+| `newsletterMute()` | Mute notifikasi channel |
+| `newsletterUnmute()` | Unmute notifikasi channel |
+| `newsletterReactMessage()` | React ke pesan channel |
+| `newsletterMetadata()` | Get metadata channel |
+| `newsletterAdminCount()` | Get jumlah admin |
+| `newsletterChangeOwner()` | Ganti owner channel |
+| `newsletterDemote()` | Demote admin channel |
+| `newsletterDelete()` | Hapus channel |
+
+</details>
+
+<details>
+<summary><b>👥 Group Management</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `groupCreate()` | Buat grup baru |
+| `groupUpdateSubject()` | Update nama grup |
+| `groupUpdateDescription()` | Update deskripsi grup |
+| `groupParticipantsUpdate()` | Add/remove/promote/demote member |
+| `groupSettingUpdate()` | Update pengaturan grup |
+| `groupMetadata()` | Get metadata grup |
+| `groupLeave()` | Keluar dari grup |
+| `groupInviteCode()` | Get kode invite grup |
+| `groupAcceptInvite()` | Join grup via invite code |
+
+</details>
+
+<details>
+<summary><b>💬 Message Types</b></summary>
+
+| Type | Description |
+|------|-------------|
+| `text` | Pesan teks biasa |
+| `image` | Kirim gambar (dengan opsi `hd: true` untuk kualitas HD) |
+| `video` | Kirim video (dengan opsi `hd: true` untuk kualitas HD) |
+| `audio` | Kirim audio |
+| `document` | Kirim dokumen |
+| `sticker` | Kirim sticker |
+| `location` | Kirim lokasi |
+| `contacts` | Kirim kontak |
+| `poll` | Buat polling |
+| `album` | Kirim album (multiple media) |
+| `react` | React ke pesan |
+| `edit` | Edit pesan |
+| `delete` | Hapus pesan |
+
+</details>
+
+<details>
+<summary><b>📷 Profile Picture</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `updateProfilePicture()` | Update foto profil (square crop) |
+| `updatePanoramaProfilePicture()` | Update foto profil panorama (wide, tidak di-crop) |
+| `removeProfilePicture()` | Hapus foto profil |
+| `profilePictureUrl()` | Get URL foto profil |
+
+</details>
+
+<details>
+<summary><b>🎮 Mini Games (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `MiniGamesManager` | Main class untuk manage semua games |
+| `games.startGuessNumber()` | Start guess number game |
+| `games.startQuiz()` | Start quiz game |
+| `games.startTicTacToe()` | Start TicTacToe (vs bot/player) |
+| `games.playRockPaperScissors()` | Play RPS game |
+| `games.rollDice()` | Roll dice (1-6) |
+| `games.flipCoin()` | Flip a coin |
+| `games.handleGuess()` | Handle guess input |
+| `games.handleMove()` | Handle TicTacToe move |
+| `games.getLeaderboard()` | Get player leaderboard |
+
+</details>
+
+<details>
+<summary><b>🔍 Content Detector (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `ContentDetector` | Main class untuk detect content |
+| `detector.analyze()` | Full content analysis |
+| `hasLinks()` | Quick check for URLs |
+| `hasPhoneNumbers()` | Quick check for phone numbers |
+| `hasEmails()` | Quick check for emails |
+| `hasMediaContent()` | Check if message has media |
+| `isForwarded()` | Check if message is forwarded |
+| `ContentFilter` | Filter messages by criteria |
+
+</details>
+
+<details>
+<summary><b>🛡️ Anti-Spam (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `AntiSpamManager` | Main anti-spam class |
+| `antispam.checkMessage()` | Check if message is spam |
+| `antispam.addRule()` | Add custom spam rule |
+| `antispam.muteUser()` | Mute user temporarily |
+| `antispam.banUser()` | Ban user permanently |
+| `antispam.whitelist()` | Add user to whitelist |
+| `antispam.getStats()` | Get spam statistics |
+
+</details>
+
+<details>
+<summary><b>🔗 Link Scanner (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `LinkScanner` | Main URL security scanner |
+| `scanner.scanUrl()` | Scan single URL |
+| `scanner.scanMessage()` | Scan all URLs in message |
+| `scanner.isUrlSafe()` | Quick safety check |
+| `scanner.addPhishingPattern()` | Add custom phishing pattern |
+| `scanner.addTrustedDomain()` | Add trusted domain |
+
+</details>
+
+<details>
+<summary><b>📝 Activity Logger (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `ActivityLogger` | Main logging class |
+| `logger.log()` | Log custom activity |
+| `logger.logMessage()` | Log message activity |
+| `logger.logUserAction()` | Log user action |
+| `logger.logGroupAction()` | Log group action |
+| `logger.query()` | Query logs with filters |
+| `logger.getStats()` | Get activity statistics |
+
+</details>
+
+<details>
+<summary><b>🎭 Meme Generator (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `MemeGenerator` | Main meme class |
+| `meme.generateTextMeme()` | Generate ASCII text meme |
+| `meme.generateSvgMeme()` | Generate SVG meme |
+| `meme.getTemplates()` | List available templates |
+| `drakeMeme()` | Quick Drake meme |
+| `expandingBrainMeme()` | Quick Expanding Brain meme |
+| `thisIsFineMeme()` | Quick "This is Fine" meme |
+
+</details>
+
+<details>
+<summary><b>🍅 Pomodoro Timer (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `PomodoroManager` | Main timer class |
+| `pomodoro.start()` | Start work session |
+| `pomodoro.break()` | Start break |
+| `pomodoro.pause()` | Pause timer |
+| `pomodoro.resume()` | Resume timer |
+| `pomodoro.stop()` | Stop and reset |
+| `pomodoro.status()` | Get current status |
+| `pomodoro.stats()` | Get statistics |
+
+</details>
+
+<details>
+<summary><b>💬 Quote Generator (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `QuoteManager` | Main quote class |
+| `getRandomQuote()` | Get random quote |
+| `getQuoteOfTheDay()` | Get daily quote |
+| `getMotivationalQuote()` | Get motivational quote |
+| `getIslamicQuote()` | Get Islamic quote |
+| `getFunnyQuote()` | Get funny quote |
+| `quoteCommand()` | Parse quote command |
+
+</details>
+
+<details>
+<summary><b>🌤️ Weather Bot (UNTESTED ⚠️)</b></summary>
+
+| Function | Description |
+|----------|-------------|
+| `WeatherBot` | Main weather class |
+| `weather.getWeather()` | Get weather for city |
+| `weather.setApiKey()` | Set OpenWeatherMap API key |
+| `getWeather()` | Quick weather helper |
+| `getSimpleWeather()` | Get simplified weather |
+| `weatherCommand()` | Parse weather command |
+
+</details>
+
+---
+
+## 🔄 Changelog
+
+<details open>
+<summary><b>v1.0.2</b> - Latest (BIG UPDATE! 🎉)</summary>
+
+### 🆕 New Features
+
+**🎮 Mini Games (UNTESTED ⚠️)**
+- Guess Number game with hints
+- Quiz with multiple categories
+- TicTacToe (vs Bot or 2 players)
+- Rock Paper Scissors
+- Dice Roll & Coin Flip
+- Score tracking and leaderboards
+
+**🔍 Content Detector (UNTESTED ⚠️)**
+- URL/Link detection with extraction
+- Phone number detection
+- Email detection
+- Media type detection (image, video, audio, document, sticker)
+- Mention and hashtag extraction
+- Emoji analysis
+- Sensitive content filtering
+- Forwarded message detection
+
+**🛡️ Anti-Spam System (UNTESTED ⚠️)**
+- Rate limiting per user
+- Duplicate message detection
+- Flood protection
+- Pattern-based spam detection
+- User mute/ban functionality
+- Whitelist support
+- Customizable rules and thresholds
+
+**🔗 Link Scanner (UNTESTED ⚠️)**
+- URL security analysis
+- Phishing detection with pattern matching
+- URL shortener expansion
+- Suspicious TLD detection
+- Domain reputation checking
+- Risk level scoring (safe/low/medium/high/critical)
+- Redirect following for shortened URLs
+
+**📝 Activity Logger (UNTESTED ⚠️)**
+- Audit trail logging
+- Multiple log levels (debug, info, warn, error, critical)
+- Category-based logging (message, user, group, bot, security)
+- File logging with rotation support
+- Query and search logs
+- Statistics and analytics
+- Memory and file output options
+
+**🎭 Meme Generator (UNTESTED ⚠️)**
+- Text-based meme templates
+- Popular meme formats (Drake, Expanding Brain, Two Buttons, etc.)
+- SVG/HTML output generation
+- Custom template support
+- Quick meme helpers
+
+**🍅 Pomodoro Timer (UNTESTED ⚠️)**
+- Productivity timer with Pomodoro technique
+- Configurable work/break durations
+- Session tracking and statistics
+- Pause/resume functionality
+- Auto-start options
+- Streak tracking
+
+**💬 Quote Generator (UNTESTED ⚠️)**
+- 40+ built-in quotes (English & Indonesian)
+- Multiple categories (motivational, inspirational, love, life, success, wisdom, funny, islamic, philosophy)
+- Quote of the day feature
+- Search quotes by text or author
+- Custom quote support
+- Formatted output styles
+
+**🌤️ Weather Bot (UNTESTED ⚠️)**
+- Real-time weather information
+- OpenWeatherMap API integration
+- Mock data for offline use
+- Detailed weather display (temp, humidity, wind, etc.)
+- Weather advice based on conditions
+- Multiple city support
+- Caching for performance
+
+**📅 Message Scheduling**
+- Schedule messages for future delivery
+- Delay-based scheduling
+- Cancel/manage scheduled messages
+
+**📨 Bulk Messaging**
+- Send to multiple recipients with rate limiting
+- Progress tracking and callbacks
+- Retry mechanism with error handling
+
+**🔄 Auto Reply System**
+- Keyword-based auto replies
+- Regex pattern matching
+- Cooldown per user/rule
+- Group/private chat filters
+
+**📇 Contact Card (vCard)**
+- Full vCard generation with all fields
+- Multi-contact support
+- Quick contact helper
+
+**📺 Status/Story Posting**
+- Text status with backgrounds & fonts
+- Image/video/voice note status
+- Pre-defined backgrounds & styles
+
+**🎤 Voice Note Helper**
+- Audio conversion to Opus format
+- PTT mode support
+- Duration detection
+
+**📋 Message Templates**
+- Pre-built templates (order, invoice, etc.)
+- Variable substitution
+- Export/import templates
+
+**📡 Broadcast Manager**
+- Create and manage broadcast lists
+- Send to multiple lists
+- Statistics and tracking
+
+**⌨️ Typing Indicator**
+- Start/stop typing simulation
+- Recording indicator for voice notes
+- Auto-pause functionality
+
+**✅ Read Receipt Control**
+- Enable/disable read receipts
+- Delay before marking read
+- Exclude specific JIDs
+
+**🔍 Message Search**
+- Full-text search in messages
+- Regex support
+- Filter by type, date, sender
+
+**📊 Chat Analytics**
+- Message statistics
+- Activity by hour/day
+- Top participants
+- Media/link/emoji counts
+
+**💾 Chat Export**
+- Export to JSON, HTML, TXT, CSV
+- Customizable templates
+- Date range filtering
+
+**🔗 QR Code Generator**
+- Multiple output formats (terminal, SVG, PNG, base64)
+- Customizable colors and styles
+- WhatsApp-styled QR
+
+**📁 Media Downloader**
+- Batch download media from chats
+- Progress tracking
+- Type filtering and size limits
+
+### ✨ Improvements
+- ✨ **HD Images & Videos** - Send uncompressed media with `hd: true`
+- ✨ **Panorama Profile Picture** - Set wide/panoramic profile pictures without cropping
+- ✨ Higher quality thumbnails for HD mode
+- 📸 Better image quality preservation
+- 🎬 Video quality improvements
+- 📝 Added complete demo code example
+- 🎨 Improved documentation structure
+- 🐛 Bug fixes and performance improvements
+
+</details>
 
 <details>
-<summary><b>v1.0.1</b> - Latest</summary>
+<summary><b>v1.0.1</b></summary>
 
 - ✨ Added Album Messages support (carousel format)
 - ✨ Added AI Message Style (`ai: true`) - shows AI indicator on messages