@kangwifi-pro/waliwa 1.1.13 → 1.1.14

package/docs/COMMUNITY.md

@@ -1,613 +0,0 @@
-# Community Features & Fixes (v1.1.0)
-
-Module `community/` berisi fitur-fitur yang sering diminta komunitas Baileys + fix untuk issue-issue yang dilaporkan.
-
-## 📋 Daftar Lengkap
-
-### Fitur Baru (10 managers)
-
-#### 1. ProfileManager (`sock.profileManager`)
-Update profile picture, about text, display name. Get profile info dengan caching.
-
-**Fix issues:**
-- Baileys: profile picture URL tidak bisa didapat
-- Baileys: about text tidak bisa di-get
-- Baileys: business account detection missing
-
-```typescript
-// Update profile picture
-await sock.profileManager.updateProfilePicture(jid, imageBuffer);
-
-// Update about text
-await sock.profileManager.updateAbout("Hey there! I'm using Waliwa");
-
-// Update display name
-await sock.profileManager.updateName("My Name");
-
-// Get profile info (cached)
-const info = await sock.profileManager.getProfileInfo(jid);
-console.log(info.name, info.about, info.profilePictureUrl, info.isBusiness);
-
-// Download profile picture
-await sock.profileManager.downloadProfilePicture(jid, './profile.jpg');
-```
-
-#### 2. PrivacyManager (`sock.privacyManager`)
-Block/unblock users, privacy settings (last seen, profile photo, about, status, read receipts).
-
-**Fix issues:**
-- Baileys: block/unblock tidak ada
-- Baileys: privacy settings tidak bisa diubah
-
-```typescript
-// Block/unblock
-await sock.privacyManager.block('user@s.whatsapp.net');
-await sock.privacyManager.unblock('user@s.whatsapp.net');
-
-// Get blocklist
-const blocked = await sock.privacyManager.getBlocklist();
-
-// Set privacy settings
-await sock.privacyManager.setLastSeenPrivacy('contacts');      // all | contacts | contact_blacklist | none
-await sock.privacyManager.setProfilePhotoPrivacy('contacts');
-await sock.privacyManager.setAboutPrivacy('contacts');
-await sock.privacyManager.setStatusPrivacy('contacts');
-await sock.privacyManager.setReadReceiptsPrivacy('none');       // Disable blue ticks
-
-// Get current privacy
-const privacy = await sock.privacyManager.getPrivacySettings();
-```
-
-#### 3. NewsletterManagerExtended (`sock.newsletterManager`)
-Full newsletter support - create, post, mute, metadata, subscribers, verification.
-
-**Fix issues:**
-- Baileys: newsletter support sangat terbatas
-- Baileys: newsletter mute tidak ada
-- Baileys: subscriber count tidak bisa di-get
-
-```typescript
-// Create newsletter
-const nl = await sock.newsletterManager.create('My Channel', 'Description');
-
-// Subscribe/unsubscribe
-await sock.newsletterManager.subscribe(nl.id);
-await sock.newsletterManager.unsubscribe(nl.id);
-
-// Mute/unmute
-await sock.newsletterManager.mute(nl.id);
-await sock.newsletterManager.unmute(nl.id);
-
-// Get metadata (subscriber count, verification, dll)
-const meta = await sock.newsletterManager.getMetadata(nl.id);
-console.log(meta.subscribersCount, meta.verification, meta.isOwner);
-
-// Post to newsletter
-await sock.newsletterManager.postText(nl.id, 'Hello channel!');
-await sock.newsletterManager.postMedia(nl.id, 'image', 'https://...', 'caption');
-
-// React to post
-await sock.newsletterManager.reactToPost(nl.id, postId, '👍');
-
-// Get posts
-const posts = await sock.newsletterManager.getPosts(nl.id, 20);
-
-// Admin: mute user
-await sock.newsletterManager.muteUser(nl.id, userJid, 3600000);
-
-// Owner: transfer ownership
-await sock.newsletterManager.transferOwnership(nl.id, newOwnerJid);
-
-// Delete newsletter
-await sock.newsletterManager.delete(nl.id);
-```
-
-#### 4. StatusExtended (`sock.statusManager`)
-Status/Stories reply, view tracking, privacy settings, album upload.
-
-**Fix issues:**
-- Baileys: status reply tidak support
-- Baileys: status view tracking missing
-- Baileys: status privacy settings tidak ada
-
-```typescript
-// Reply ke status
-await sock.statusManager.replyToStatus(authorJid, statusId, 'Nice status!');
-
-// React to status
-await sock.statusManager.reactToStatus(authorJid, statusId, '❤️');
-
-// Get who viewed your status
-const views = await sock.statusManager.getStatusViews(statusId);
-console.log(`${views.length} people viewed your status`);
-
-// Get recent statuses dari contacts
-const statuses = await sock.statusManager.getRecentStatuses(50);
-
-// Upload text status with background
-await sock.statusManager.sendTextStatus('Hello!', { backgroundColor: '#FF0000' });
-
-// Upload status album (multiple items sekaligus)
-await sock.statusManager.sendStatusAlbum([
-  { type: 'image', mediaUrl: 'https://...', caption: 'Photo 1' },
-  { type: 'text', text: 'Caption', backgroundColor: '#0000FF' },
-  { type: 'video', mediaUrl: 'https://...' }
-]);
-
-// Get/Set status privacy
-const privacy = await sock.statusManager.getPrivacy();
-await sock.statusManager.setPrivacy({
-  whoCanSee: 'whitelist',
-  whitelist: ['user1@s.whatsapp.net', 'user2@s.whatsapp.net']
-});
-
-// Forward status to contacts
-await sock.statusManager.forwardStatus(authorJid, statusId, [user1, user2]);
-
-// Mark status as seen
-await sock.statusManager.markAsSeen(authorJid, [statusId1, statusId2]);
-
-// Delete own status
-await sock.statusManager.deleteStatus(statusId);
-```
-
-#### 5. ContactsManager (`sock.contactsManager`)
-Sync contacts, check if registered, search.
-
-**Fix issues:**
-- Baileys: contact sync tidak reliable
-- Baileys: tidak bisa check jika nomor terdaftar di WhatsApp
-
-```typescript
-// Sync multiple contacts (check if registered)
-const contacts = await sock.contactsManager.syncContacts([
-  '6281234567890',
-  '6289876543210',
-  '621234567890'
-]);
-
-for (const [phone, info] of contacts.entries()) {
-  console.log(`${phone}: ${info.isRegistered ? '✓ registered' : '✗ not registered'}`);
-}
-
-// Check single number
-const isRegistered = await sock.contactsManager.checkRegistered('6281234567890');
-
-// Get contact info
-const info = await sock.contactsManager.getContactInfo('6281234567890');
-
-// Search contacts by name/number
-const results = sock.contactsManager.searchContacts('John', 20);
-
-// Get all cached contacts
-const all = sock.contactsManager.getAllContacts();
-```
-
-#### 6. BulkOperations (`sock.bulkOps`)
-Bulk send, broadcast, album send dengan rate limiting.
-
-**Fix issues:**
-- Baileys: bulk send tidak ada
-- Baileys: broadcast tidak ada delay control
-- Baileys: multi-file send tidak support
-
-```typescript
-// Bulk send multiple messages dengan delay
-const items = [
-  { jid: 'user1@s.whatsapp.net', content: { text: 'Hello 1' } },
-  { jid: 'user2@s.whatsapp.net', content: { text: 'Hello 2' } },
-  { jid: 'user3@s.whatsapp.net', content: { text: 'Hello 3' } }
-];
-
-const results = await sock.bulkOps.bulkSend(items, {
-  delayMs: 1000,           // 1s delay between sends
-  concurrency: 5,         // Max 5 concurrent
-  stopOnError: false,     // Continue on failure
-  onProgress: (current, total) => console.log(`${current}/${total}`)
-});
-
-// Broadcast same message to multiple recipients
-await sock.bulkOps.broadcast(
-  { text: 'Announcement!' },
-  ['user1@s.whatsapp.net', 'user2@s.whatsapp.net'],
-  { delayMs: 2000 }
-);
-
-// Send album (multiple media files)
-await sock.bulkOps.sendAlbum(jid, [
-  { type: 'image', stream: image1, mimetype: 'image/jpeg', caption: 'Photo 1' },
-  { type: 'image', stream: image2, mimetype: 'image/jpeg', caption: 'Photo 2' },
-  { type: 'video', stream: video, mimetype: 'video/mp4' }
-]);
-
-// Send with retry
-const result = await sock.bulkOps.sendWithRetry(jid, content, 3, 2000);
-```
-
-#### 7. MessageExtras (`sock.messageExtras`)
-Edit message, star/unstar, pin, view-once download, message info.
-
-**Fix issues:**
-- Baileys: edit message tidak support
-- Baileys: star messages tidak ada
-- Baileys: view once media tidak bisa didownload
-- Baileys: message read/delivery info missing
-
-```typescript
-// Edit message yang sudah dikirim
-await sock.messageExtras.editMessage(jid, key, 'Edited text');
-
-// Star/unstar message
-await sock.messageExtras.starMessage(key, true);   // star
-await sock.messageExtras.starMessage(key, false);   // unstar
-
-// Get starred messages in a chat
-const starred = await sock.messageExtras.getStarredMessages(jid, 50);
-
-// Pin message in chat
-await sock.messageExtras.pinMessage(key, 24 * 60 * 60 * 1000);  // pin for 24h
-await sock.messageExtras.unpinMessage(key);
-
-// Mark chat as unread
-await sock.messageExtras.markChatAsUnread(jid);
-
-// Get message info (read by, delivered to)
-const info = await sock.messageExtras.getMessageInfo(key);
-console.log('Status:', info.status);
-console.log('Delivered to:', info.deliveredTo);
-console.log('Read by:', info.readBy);
-console.log('Played by:', info.playedBy);
-
-// Download view-once media (bypass protection)
-const buffer = await sock.messageExtras.downloadViewOnceMedia(message);
-
-// Remove reaction
-await sock.messageExtras.removeReaction(key);
-
-// Forward with additional context
-await sock.messageExtras.forwardWithContext(toJid, originalMessage, 'Check this out!');
-```
-
-#### 8. DisappearingManager (`sock.disappearingManager`)
-Set disappearing messages timer per chat.
-
-**Fix issues:**
-- Baileys: disappearing messages control tidak ada
-- Baileys: tidak bisa set timer per chat
-
-```typescript
-// Set timer for a chat
-await sock.disappearingManager.setTimer(jid, '24_hours');
-await sock.disappearingManager.setTimer(jid, '7_days');
-await sock.disappearingManager.setTimer(jid, '90_days');
-await sock.disappearingManager.setTimer(jid, 'off');  // disable
-
-// Get current setting
-const timer = await sock.disappearingManager.getSetting(jid);
-
-// Set default timer untuk new chats
-await sock.disappearingManager.setDefaultTimer('7_days');
-
-// Get all chats with disappearing enabled
-const chats = sock.disappearingManager.getDisappearingChats();
-```
-
-#### 9. LiveLocationManager (`sock.liveLocationManager`)
-Share live location dengan real-time updates.
-
-**Fix issues:**
-- Baileys: live location tidak support
-- Baileys: tidak bisa stop live location
-
-```typescript
-// Start sharing live location
-await sock.liveLocationManager.startSharing(jid, {
-  latitude: -6.2088,
-  longitude: 106.8456,
-  accuracy: 10,
-  speed: 0,
-  heading: 180,
-  altitude: 50,
-  expiration: 3600,  // 1 hour
-  caption: 'On my way!'
-});
-
-// Update location
-await sock.liveLocationManager.updateLocation(jid, {
-  latitude: -6.2090,
-  longitude: 106.8460
-});
-
-// Stop sharing
-await sock.liveLocationManager.stopSharing(jid);
-
-// Stop all active sharing
-await sock.liveLocationManager.stopAllSharing();
-
-// Send static location (non-live)
-await sock.liveLocationManager.sendStaticLocation(jid, -6.2088, 106.8456, {
-  name: 'Jakarta',
-  address: 'Indonesia'
-});
-
-// Parse incoming live location
-const loc = sock.liveLocationManager.parseLiveLocationMessage(message);
-```
-
-#### 10. StickerManager (`sock.stickerManager`)
-Create dan send custom stickers, sticker packs.
-
-**Fix issues:**
-- Baileys: custom sticker support kurang
-- Baileys: sticker pack tidak support
-
-```typescript
-// Send sticker dari image buffer (WebP format)
-await sock.stickerManager.sendSticker(jid, webpBuffer, {
-  packName: 'My Pack',
-  author: 'Me',
-  emojis: ['😀'],
-  isAnimated: false
-});
-
-// Create sticker pack dari multiple images
-const pack = await sock.stickerManager.createStickerPack(
-  'My Sticker Pack',
-  'Author Name',
-  [
-    { buffer: webp1, emojis: ['😀'] },
-    { buffer: webp2, emojis: ['😂'], isAnimated: true },
-    { buffer: webp3, emojis: ['😍'] }
-  ]
-);
-
-// Get sticker pack info
-const info = await sock.stickerManager.getStickerPack(pack.id);
-
-// Delete sticker pack
-await sock.stickerManager.deleteStickerPack(pack.id);
-
-// Favorite a sticker
-await sock.stickerManager.favoriteSticker(stickerId, fileSha256);
-```
-
-#### 11. AudioTranscriptionManager
-Audio transcription dengan pluggable provider (Whisper, Google, dll).
-
-```typescript
-import { AudioTranscriptionManager } from '@kangwifi-pro/waliwa';
-
-const atm = new AudioTranscriptionManager();
-
-// Use Whisper API
-atm.setProvider(AudioTranscriptionManager.whisperProvider(process.env.OPENAI_API_KEY));
-
-// Transcribe audio
-const result = await atm.transcribe(audioBuffer, 'audio/ogg', 'audio-msg-123');
-console.log(result.text);  // "Hello, this is a voice message"
-```
-
----
-
-### Fixes (7 trackers)
-
-#### 1. TypingIndicatorTracker (`sock.typingTracker`)
-Reliable typing indicator dengan auto-timeout.
-
-**Fix:** Baileys issue - typing indicator tidak reliable
-
-```typescript
-sock.typingTracker.on('typing:start', ({ jid, type, timestamp }) => {
-  console.log(`${jid} is ${type}...`);
-});
-
-sock.typingTracker.on('typing:stop', ({ jid, reason }) => {
-  console.log(`${jid} stopped typing (${reason})`);
-});
-
-// Manual check
-if (sock.typingTracker.isTyping('user@s.whatsapp.net')) {
-  console.log('User is typing');
-}
-
-// Get all currently typing users
-const typing = sock.typingTracker.getAllTyping();
-```
-
-#### 2. LastSeenTracker (`sock.lastSeenTracker`)
-Track last seen timestamps.
-
-**Fix:** Baileys issue - last seen tidak bisa di-get
-
-```typescript
-// Auto-updated dari presence events
-const lastSeen = sock.lastSeenTracker.getLastSeen('user@s.whatsapp.net');
-const isOnline = sock.lastSeenTracker.isOnline('user@s.whatsapp.net');
-
-// Formatted
-const formatted = sock.lastSeenTracker.getFormattedLastSeen('user@s.whatsapp.net');
-// "online now" | "5 minutes ago" | "2 hours ago" | "3 days ago"
-```
-
-#### 3. MessageStatusTracker (`sock.messageStatusTracker`)
-Real-time message status tracking dengan detailed info.
-
-**Fix:** Baileys issue - message status tidak real-time
-
-```typescript
-sock.messageStatusTracker.on('status:update', ({ key, status, timestamp }) => {
-  console.log(`Message ${key.id}: ${status} at ${new Date(timestamp).toISOString()}`);
-});
-
-// Get detailed info
-const info = sock.messageStatusTracker.getStatusInfo(messageId);
-// { status: 'read', timestamp, deliveredTo: [...], readBy: [...] }
-
-// Find stuck messages (pending > 5 min)
-const stuck = sock.messageStatusTracker.getStuckMessages();
-```
-
-#### 4. SelfMessageFilter (`sock.selfFilter`)
-Filter self messages otomatis.
-
-**Fix:** Baileys issue - self message detection missing
-
-```typescript
-// Auto-set dari creds.me
-sock.selfFilter.setOwnJid('6281@s.whatsapp.net');
-
-// Check if message is from self
-const isSelf = sock.selfFilter.isSelfMessage(jid);
-const isSelfKey = sock.selfFilter.isSelfKey(message.key);
-
-// Filter batch
-const filtered = sock.selfFilter.filterSelfMessages(messages);
-```
-
-#### 5. ChatStateManager (`sock.chatStateManager`)
-Reliable chat state persistence (archive, pin, mute).
-
-**Fix:** Baileys issue - archive/pin tidak reliable (lost on restart)
-
-```typescript
-// Archive/unarchive
-sock.chatStateManager.archive(jid);
-sock.chatStateManager.unarchive(jid);
-
-// Pin/unpin (with optional duration)
-sock.chatStateManager.pin(jid, 7 * 24 * 60 * 60 * 1000);  // pin for 7 days
-sock.chatStateManager.unpin(jid);
-
-// Mute/unmute
-sock.chatStateManager.mute(jid, 8 * 60 * 60 * 1000);  // mute for 8 hours
-sock.chatStateManager.unmute(jid);
-
-// Mark as read/unread
-sock.chatStateManager.markAsRead(jid);
-sock.chatStateManager.markAsUnread(jid);
-
-// Get lists
-const archived = sock.chatStateManager.getArchivedChats();
-const pinned = sock.chatStateManager.getPinnedChats();
-const muted = sock.chatStateManager.getMutedChats();
-
-// Serialize untuk persistence
-const data = sock.chatStateManager.serialize();
-// Save to file/DB...
-
-// Restore on restart
-sock.chatStateManager.deserialize(savedData);
-```
-
-#### 6. DeviceInfoTracker (`sock.deviceInfoTracker`)
-Battery status dan device info tracking.
-
-**Fix:** Baileys issue - battery status tidak terdeteksi, phone info tidak bisa di-get
-
-```typescript
-sock.deviceInfoTracker.on('battery:update', ({ level, isCharging }) => {
-  console.log(`Battery: ${level}% ${isCharging ? '⚡' : ''}`);
-});
-
-sock.deviceInfoTracker.on('battery:low', ({ level }) => {
-  console.warn(`⚠️ Battery low: ${level}%`);
-});
-
-// Manual check
-const level = sock.deviceInfoTracker.getBatteryLevel();
-const isCharging = sock.deviceInfoTracker.isDeviceCharging();
-const deviceInfo = sock.deviceInfoTracker.getDeviceInfo();
-```
-
-#### 7. GroupEventsTracker (`sock.groupEventsTracker`)
-Detect group changes (subject, description, announce, restrict, participant count).
-
-**Fix:** Baileys issue - group subject/description/announce changes tidak terdeteksi
-
-```typescript
-sock.groupEventsTracker.on('group:subject_change', ({ groupJid, oldSubject, newSubject }) => {
-  console.log(`Group ${groupJid}: ${oldSubject} -> ${newSubject}`);
-});
-
-sock.groupEventsTracker.on('group:description_change', ({ groupJid, oldDescription, newDescription }) => {
-  console.log(`Group ${groupJid} description changed`);
-});
-
-sock.groupEventsTracker.on('group:announce_change', ({ groupJid, announce }) => {
-  console.log(`Group ${groupJid} ${announce ? 'now admins only' : 'all can send'}`);
-});
-
-sock.groupEventsTracker.on('group:restrict_change', ({ groupJid, restrict }) => {
-  console.log(`Group ${groupJid} ${restrict ? 'now restricted' : 'now open'}`);
-});
-
-sock.groupEventsTracker.on('group:participant_count_change', ({ groupJid, oldCount, newCount }) => {
-  console.log(`Group ${groupJid}: ${oldCount} -> ${newCount} participants`);
-});
-```
-
----
-
-### Helper Functions
-
-#### parseGroupInviteInfo
-Parse info dari group invite link.
-
-```typescript
-import { parseGroupInviteInfo } from '@kangwifi-pro/waliwa';
-
-// Get info dari invite link (returns GroupInviteInfo)
-const info = parseGroupInviteInfo(responseNode);
-// { code, groupJid, subject, description, participantsCount, isCommunity, ... }
-```
-
-#### detectLanguageFromText
-Detect language dari text.
-
-```typescript
-import { detectLanguageFromText } from '@kangwifi-pro/waliwa';
-
-detectLanguageFromText('Hello world');     // 'en'
-detectLanguageFromText('こんにちは');        // 'ja'
-detectLanguageFromText('مرحبا');            // 'ar'
-detectLanguageFromText('你好');              // 'zh'
-```
-
----
-
-## Ringkasan Perbaikan Issue Baileys
-
-| Issue Baileys | Fix | Module |
-|--------------|-----|--------|
-| Profile picture URL tidak bisa didapat | ProfileManager.fetchProfilePictureUrl | profile-manager |
-| About text tidak bisa di-get | ProfileManager.fetchAbout | profile-manager |
-| Business account detection missing | ProfileManager.checkBusinessAccount | profile-manager |
-| Block/unblock tidak ada | PrivacyManager.block/unblock | privacy-manager |
-| Privacy settings tidak bisa diubah | PrivacyManager.setPrivacy | privacy-manager |
-| Newsletter support terbatas | NewsletterManagerExtended (10 methods) | newsletter-extended |
-| Status reply tidak support | StatusExtended.replyToStatus | status-extended |
-| Status view tracking missing | StatusExtended.getStatusViews | status-extended |
-| Status privacy settings tidak ada | StatusExtended.getPrivacy/setPrivacy | status-extended |
-| Contact sync tidak reliable | ContactsManager.syncContacts | contacts-manager |
-| Tidak bisa check nomor terdaftar | ContactsManager.checkRegistered | contacts-manager |
-| Bulk send tidak ada | BulkOperations.bulkSend | bulk-operations |
-| Multi-file send tidak support | BulkOperations.sendAlbum | bulk-operations |
-| Edit message tidak support | MessageExtras.editMessage | message-extras |
-| Star messages tidak ada | MessageExtras.starMessage | message-extras |
-| View once media tidak bisa didownload | MessageExtras.downloadViewOnceMedia | message-extras |
-| Message read/delivery info missing | MessageExtras.getMessageInfo | message-extras |
-| Disappearing messages control tidak ada | DisappearingManager.setTimer | disappearing |
-| Live location tidak support | LiveLocationManager.startSharing | live-location |
-| Custom sticker support kurang | StickerManager.sendSticker | sticker-manager |
-| Sticker pack tidak support | StickerManager.createStickerPack | sticker-manager |
-| Typing indicator tidak reliable | TypingIndicatorTracker | community-fixes |
-| Last seen tidak bisa di-get | LastSeenTracker | community-fixes |
-| Message status tidak real-time | MessageStatusTracker | community-fixes |
-| Self message detection missing | SelfMessageFilter | community-fixes |
-| Archive/pin tidak reliable | ChatStateManager | community-fixes |
-| Battery status tidak terdeteksi | DeviceInfoTracker | community-fixes |
-| Phone info tidak bisa di-get | DeviceInfoTracker | community-fixes |
-| Group changes tidak terdeteksi | GroupEventsTracker | community-fixes |
-| Group invite link info tidak support | parseGroupInviteInfo | community-fixes |
-
-**Total: 28+ issue Baileys di-fix di v1.1.0**