@kangwifi-pro/waliwa 3.0.0 → 3.0.1

package/dist/index.d.ts

@@ -37,7 +37,7 @@ export { MessageBuilder, ButtonBuilder, CarouselBuilder, AIRichBuilder, type But
 export { CommandSystem, type CommandContext, type CommandOptions, type CommandSystemOptions } from './helpers/command.js';
 export { AutoRejectCall, AutoRead, AutoPresence, Broadcast, Scheduler, RateLimiter } from './helpers/automation.js';
 export { PluginRegistry, PluginLoader, definePlugin, type Plugin, type PluginContext } from './helpers/plugin.js';
-export declare const VERSION = "3.0.0";
+export declare const VERSION = "3.0.1";
 export declare const LIBRARY_NAME = "waliwa";
 export declare const BASED_ON = "Baileys 7 + zaileys + baileys-mbuilder";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -86,7 +86,7 @@ Object.defineProperty(exports, "PluginRegistry", { enumerable: true, get: functi
 Object.defineProperty(exports, "PluginLoader", { enumerable: true, get: function () { return plugin_js_1.PluginLoader; } });
 Object.defineProperty(exports, "definePlugin", { enumerable: true, get: function () { return plugin_js_1.definePlugin; } });
 // ============== Version ==============
-exports.VERSION = '3.0.0';
+exports.VERSION = '3.0.1';
 exports.LIBRARY_NAME = 'waliwa';
 exports.BASED_ON = 'Baileys 7 + zaileys + baileys-mbuilder';
 //# sourceMappingURL=index.js.map

package/docs/API.md

@@ -0,0 +1,311 @@
+# API Reference
+
+## Core (Baileys 7 Re-exports)
+
+| Export | Description |
+|--------|-------------|
+| `makeWASocket(config)` | Create WA socket (Baileys 7) |
+| `useMultiFileAuthState(folder)` | File-based auth state |
+| `useMultiFileAuthState` as `useAuthState` | Alias |
+| `BufferJSON` | JSON serialization helpers |
+| `proto` | Protobuf definitions |
+| `Browsers` | Browser presets |
+| `DisconnectReason` | Disconnect reason enum |
+| `fetchLatestBaileysVersion()` | Fetch latest WA version |
+| `getContentType(msg)` | Get message content type |
+| `getDevice(msg)` | Get device info |
+| `jidDecode(jid)` | Decode JID |
+| `jidEncode(user, server)` | Encode JID |
+| `jidNormalizedUser(jid)` | Normalize JID |
+| `S_WHATSAPP_NET` | `"s.whatsapp.net"` constant |
+
+## Waliwa Exports
+
+### quickStart
+
+```typescript
+quickStart({
+  authFolder: string,
+  browser?: [string, string, string],
+  printQRInTerminal?: boolean,      // default: true
+  autoReconnect?: boolean,          // default: true
+  reconnectDelayMs?: number,        // default: 5000
+  markOnlineOnConnect?: boolean,    // default: true
+  syncFullHistory?: boolean,        // default: false
+  onOpen?: () => void,
+  onClose?: (statusCode: number, shouldReconnect: boolean) => void
+}): Promise<WASocket>
+```
+
+### makeWASocketWithDefaults
+
+Same as quickStart but accepts `authState` directly instead of `authFolder`.
+
+### MessageBuilder
+
+```typescript
+new MessageBuilder(sock)
+  .to(jid)
+  .text(content)              // Set text
+  .image(buffer, opts?)        // Set image
+  .video(buffer, opts?)        // Set video
+  .audio(buffer, opts?)        // Set audio
+  .document(buffer, opts)     // Set document
+  .sticker(buffer)             // Set sticker
+  .location(lat, lon, opts?)   // Set location
+  .contact(vcard, name?)       // Set contact
+  .poll(question, options, opts?)  // Set poll
+  .buttons(btns, opts?)         // Set buttons
+  .carousel(cards, opts?)       // Set carousel
+  .list(opts)                   // Set list message
+  .reply(message)               // Reply to message
+  .mentions(jids)               // Set mentions
+  .mentionAll()                 // Mention all group members (async)
+  .viewOnce()                   // View once
+  .ephemeral(seconds)           // Ephemeral
+  .send()                       // Send (async)
+  .forwardTo(jid)               // Forward (async)
+  .broadcast(jids, delayMs)     // Broadcast (async)
+```
+
+### ButtonBuilder
+
+```typescript
+new ButtonBuilder()
+  .text(body)
+  .button(label, id)    // max 3
+  .footer(text)
+  .header(text)
+  .viewOnce()
+  .build()               // returns content object
+  .send(sock, jid)       // send directly
+```
+
+### CarouselBuilder
+
+```typescript
+new CarouselBuilder()
+  .card(c => c
+    .image(src)
+    .title(text)
+    .text(text)
+    .button(label, id)
+  )
+  .build()
+  .send(sock, jid)
+```
+
+### AIRichBuilder
+
+```typescript
+new AIRichBuilder()
+  .text(content)              // supports [text](url) syntax
+  .extract(enabled?)           // default: true
+  .hyperlink(enabled?)         // default: true
+  .citation(enabled?)          // default: true
+  .latex(enabled?)             // default: true
+  .build()
+  .send(sock, jid)
+```
+
+### CommandSystem
+
+```typescript
+new CommandSystem(sock, {
+  prefix: '!' | ['!', '/'],
+  ownerIds?: string[],
+  caseSensitive?: boolean      // default: false
+})
+
+cmd.command(name | string[], handler)
+cmd.command(name | string[], options, handler)
+cmd.use(middleware)
+cmd.ban(jid)
+cmd.unban(jid)
+cmd.addOwner(jid)
+cmd.getCommands()
+cmd.attach()
+```
+
+#### CommandContext
+
+Properties: `sock`, `message`, `jid`, `sender`, `text`, `command`, `args`, `fullText`, `isGroup`, `isFromMe`, `isOwner`, `senderName`, `quoted`, `mentions`
+
+Methods: `reply(text)`, `replyWithMedia(buffer)`, `react(emoji)`, `sendTyping()`, `sendRecording()`, `stopTyping()`
+
+### AutoRejectCall
+
+```typescript
+new AutoRejectCall(sock)
+  .start()
+  .allow(jid)
+  .stop()
+```
+
+### AutoRead
+
+```typescript
+new AutoRead(sock, { excludeGroups?: boolean })
+  .start()
+  .stop()
+```
+
+### AutoPresence
+
+```typescript
+new AutoPresence(sock)
+  .start()
+  .stop()
+```
+
+### Broadcast
+
+```typescript
+new Broadcast(sock, defaultDelayMs?)
+  .send(jids, content, { delayMs?, onProgress? })    // returns [{ jid, success, error? }]
+  .sendText(jids, text, opts?)
+```
+
+### Scheduler
+
+```typescript
+new Scheduler(sock)
+  .schedule(id, jid, content, delayMs)    // returns id
+  .cancel(id)                              // returns boolean
+  .list()                                   // returns [{ id, jid }]
+  .cancelAll()
+```
+
+### RateLimiter
+
+```typescript
+new RateLimiter()
+  .setLimit(jid, max, windowMs)
+  .canSend(jid)                             // returns boolean
+  .getRemaining(jid)                        // returns number
+  .reset(jid)
+```
+
+### PluginRegistry
+
+```typescript
+new PluginRegistry(sock)
+  .register(plugin, config?)
+  .unregister(name)
+  .get(name)                                // returns Plugin
+  .list()                                   // returns [{ name, version, description }]
+  .has(name)                                // returns boolean
+  .unloadAll()
+```
+
+### PluginLoader
+
+```typescript
+new PluginLoader(sock)
+  .getRegistry()                            // returns PluginRegistry
+  .loadFromDir(dir)                         // load all .js/.mjs files
+  .loadFile(filePath)                       // load single file
+```
+
+### definePlugin
+
+```typescript
+definePlugin({
+  name: string,
+  version?: string,
+  description?: string,
+  dependencies?: string[],
+  onLoad?: (ctx) => void | Promise<void>,
+  onUnload?: () => void | Promise<void>,
+  onMessage?: (msg, ctx) => void | Promise<void>,
+  onConnectionUpdate?: (update, ctx) => void | Promise<void>,
+  commands?: Array<{ name, description?, handler }>
+}): Plugin
+```
+
+### MediaHelper
+
+Static methods:
+
+| Method | Description |
+|--------|-------------|
+| `downloadFromMessage(sock, msg)` | Download media dari message |
+| `downloadFromUrl(url)` | Download dari URL |
+| `resizeImage(buffer, w, h, opts?)` | Resize image |
+| `toWebP(buffer, opts?)` | Convert ke WebP |
+| `toJPEG(buffer, quality?)` | Convert ke JPEG |
+| `toPNG(buffer)` | Convert ke PNG |
+| `getMetadata(buffer)` | Get { width, height, format, size } |
+| `getMimeType(filename)` | Get MIME dari filename |
+| `getExtension(mimetype)` | Get extension dari MIME |
+| `saveToFile(buffer, path)` | Save ke file |
+| `readFromFile(path)` | Read file ke buffer |
+| `compress(buffer, quality?)` | Compress image |
+| `createThumbnail(buffer, size?)` | Create thumbnail |
+| `rotate(buffer, degrees)` | Rotate image |
+| `flip(buffer, direction)` | Flip horizontal/vertical |
+| `grayscale(buffer)` | Grayscale |
+| `blur(buffer, sigma?)` | Blur |
+| `addWatermark(buffer, text, opts?)` | Add text watermark |
+| `toDataUrl(buffer, mimetype)` | Convert ke data URL |
+| `fromDataUrl(dataUrl)` | Convert dari data URL |
+| `formatSize(bytes)` | Format bytes ke human-readable |
+
+### StickerHelper
+
+Static methods:
+
+| Method | Description |
+|--------|-------------|
+| `fromImage(buffer, opts?)` | Sticker dari image |
+| `fromVideo(buffer, opts?)` | Animated sticker dari video |
+| `fromText(text, opts?)` | Sticker dari text |
+| `fromFile(path, opts?)` | Sticker dari file |
+| `fromUrl(url, opts?)` | Sticker dari URL |
+| `normalize(buffer)` | Resize ke 512x512 WebP |
+| `isWebP(buffer)` | Check jika WebP |
+| `getDimensions(buffer)` | Get { width, height } |
+
+StickerOptions: `{ pack?, author?, categories?, quality?, width?, height?, background?, fit? }`
+
+### MessageHelper
+
+Static methods:
+
+| Method | Description |
+|--------|-------------|
+| `getText(msg)` | Extract text dari message |
+| `hasMedia(msg)` | Check jika ada media |
+| `getMediaType(msg)` | Get media type string |
+| `getSender(msg)` | Get sender JID |
+| `getChat(msg)` | Get chat JID |
+| `isFromMe(msg)` | Check jika dari bot |
+| `isGroupMessage(msg)` | Check jika dari grup |
+| `getMentions(msg)` | Get mentioned JIDs |
+| `getQuoted(msg)` | Get quoted message |
+| `reply(sock, msg, text, opts?)` | Reply ke message |
+| `sendText(sock, jid, text, opts?)` | Send text |
+| `sendWithMentions(sock, jid, text, jids)` | Send dengan mentions |
+| `mentionAll(sock, groupJid, text?)` | Mention all members |
+| `forward(sock, toJid, msg)` | Forward message |
+| `delete(sock, msg)` | Delete message |
+| `react(sock, msg, emoji)` | React ke message |
+| `markAsRead(sock, key)` | Mark as read |
+| `sendTyping(sock, jid)` | Typing indicator |
+| `sendRecording(sock, jid)` | Recording indicator |
+| `stopTyping(sock, jid)` | Stop typing |
+| `formatTimestamp(ts)` | Format timestamp |
+| `parseCommand(msg, prefix?)` | Parse command |
+| `isCommand(msg, prefix?)` | Check jika command |
+| `extractUrls(text)` | Extract URLs |
+| `hasUrl(msg)` | Check jika ada URL |
+| `getStatus(msg)` | Get message status |
+| `isEmpty(msg)` | Check jika empty |
+
+## Constants
+
+| Export | Value |
+|--------|-------|
+| `VERSION` | `'3.0.0'` |
+| `LIBRARY_NAME` | `'waliwa'` |
+| `BASED_ON` | `'Baileys 7 + zaileys + baileys-mbuilder'` |

package/docs/EXAMPLES.md

@@ -0,0 +1,204 @@
+# Examples
+
+Complete examples untuk berbagai use case.
+
+## 1. Echo Bot
+
+```typescript
+import { quickStart, MessageHelper } from '@kangwifi-pro/waliwa';
+
+const sock = await quickStart({ authFolder: './auth' });
+
+sock.ev.on('messages.upsert', async ({ messages, type }) => {
+  if (type !== 'notify') return;
+  for (const msg of messages) {
+    if (MessageHelper.isFromMe(msg)) continue;
+    const text = MessageHelper.getText(msg);
+    if (text) await MessageHelper.reply(sock, msg, `Echo: ${text}`);
+  }
+});
+```
+
+## 2. Command Bot
+
+```typescript
+import { quickStart, CommandSystem } from '@kangwifi-pro/waliwa';
+
+const sock = await quickStart({ authFolder: './auth' });
+
+const cmd = new CommandSystem(sock, { prefix: '!', ownerIds: ['628xxx@s.whatsapp.net'] });
+
+cmd.command('ping', async (ctx) => {
+  await ctx.reply('pong! 🏓');
+});
+
+cmd.command('menu', async (ctx) => {
+  const commands = cmd.getCommands();
+  const menu = commands.map(c => `!${c.name} - ${c.description || ''}`).join('\n');
+  await ctx.reply(`*Menu*\n\n${menu}`);
+});
+
+cmd.command('kick', { adminOnly: true, cooldown: 5000 }, async (ctx) => {
+  const target = ctx.mentions[0] || ctx.quoted?.participant;
+  if (!target) return ctx.reply('Tag atau reply user');
+  await sock.groupParticipantsUpdate(ctx.jid, [target], 'remove');
+});
+
+cmd.use(async (ctx, next) => {
+  console.log(`[${ctx.senderName}] ${ctx.fullText}`);
+  await next();
+});
+
+cmd.attach();
+```
+
+## 3. Sticker Bot
+
+```typescript
+import { quickStart, MessageHelper, MediaHelper, StickerHelper } from '@kangwifi-pro/waliwa';
+
+const sock = await quickStart({ authFolder: './auth' });
+
+sock.ev.on('messages.upsert', async ({ messages, type }) => {
+  if (type !== 'notify') return;
+  for (const msg of messages) {
+    if (MessageHelper.isFromMe(msg)) continue;
+    const text = MessageHelper.getText(msg);
+
+    if (text === '!sticker' && MessageHelper.hasMedia(msg)) {
+      await MessageHelper.sendTyping(sock, msg.key.remoteJid);
+      const buffer = await MediaHelper.downloadFromMessage(sock, msg);
+      const sticker = await StickerHelper.fromImage(buffer, { pack: 'Waliwa', author: 'Bot' });
+      await sock.sendMessage(msg.key.remoteJid, { sticker });
+      await MessageHelper.stopTyping(sock, msg.key.remoteJid);
+    }
+  }
+});
+```
+
+## 4. Auto Bot (Read + Reject Call + Typing)
+
+```typescript
+import { quickStart, AutoRead, AutoRejectCall, AutoPresence, CommandSystem } from '@kangwifi-pro/waliwa';
+
+const sock = await quickStart({ authFolder: './auth' });
+
+// Enable auto features
+new AutoRead(sock).start();
+new AutoRejectCall(sock).start();
+new AutoPresence(sock).start();
+
+// Commands
+const cmd = new CommandSystem(sock, { prefix: '!' });
+cmd.command('ping', async (ctx) => ctx.reply('pong!'));
+cmd.attach();
+```
+
+## 5. Broadcast Bot
+
+```typescript
+import { quickStart, Broadcast } from '@kangwifi-pro/waliwa';
+
+const sock = await quickStart({ authFolder: './auth' });
+
+const broadcast = new Broadcast(sock, 2000); // 2s delay between sends
+
+// Broadcast to all group participants
+sock.ev.on('messages.upsert', async ({ messages }) => {
+  for (const msg of messages) {
+    if (msg.message?.conversation === '!broadcast') {
+      const jid = msg.key.remoteJid;
+      if (!jid.endsWith('@g.us')) return;
+
+      const metadata = await sock.groupMetadata(jid);
+      const targets = metadata.participants.map(p => p.id);
+
+      const results = await broadcast.sendText(targets, '📢 Announcement!');
+      const success = results.filter(r => r.success).length;
+      await sock.sendMessage(jid, { text: `✅ Sent to ${success}/${targets.length}` });
+    }
+  }
+});
+```
+
+## 6. Plugin-based Bot
+
+```typescript
+import { quickStart, PluginLoader } from '@kangwifi-pro/waliwa';
+
+const sock = await quickStart({ authFolder: './auth' });
+
+const loader = new PluginLoader(sock);
+await loader.loadFromDir('./plugins');
+
+// plugins/ping.ts:
+// export default definePlugin({
+//   name: 'ping',
+//   onMessage: async (msg, ctx) => {
+//     if (msg.message?.conversation === '!ping') {
+//       await ctx.sock.sendMessage(msg.key.remoteJid, { text: 'pong!' });
+//     }
+//   }
+// });
+```
+
+## 7. Message Builder Bot
+
+```typescript
+import { quickStart, MessageBuilder } from '@kangwifi-pro/waliwa';
+
+const sock = await quickStart({ authFolder: './auth' });
+
+sock.ev.on('messages.upsert', async ({ messages }) => {
+  for (const msg of messages) {
+    if (msg.message?.conversation === '!menu') {
+      const builder = new MessageBuilder(sock);
+      await builder
+        .to(msg.key.remoteJid)
+        .text('Choose an option:')
+        .buttons([
+          { label: 'Info', id: 'info' },
+          { label: 'Help', id: 'help' },
+          { label: 'Cancel', id: 'cancel' }
+        ])
+        .footer('Powered by Waliwa')
+        .reply(msg)
+        .send();
+    }
+  }
+});
+```
+
+## 8. Scheduler Bot
+
+```typescript
+import { quickStart, Scheduler, CommandSystem } from '@kangwifi-pro/waliwa';
+
+const sock = await quickStart({ authFolder: './auth' });
+const scheduler = new Scheduler(sock);
+
+const cmd = new CommandSystem(sock, { prefix: '!' });
+
+// !remind 10 Check the oven
+cmd.command('remind', async (ctx) => {
+  const minutes = parseInt(ctx.args[0]);
+  const text = ctx.args.slice(1).join(' ');
+  if (!minutes || !text) return ctx.reply('Usage: !remind <minutes> <text>');
+
+  const id = `remind-${Date.now()}`;
+  scheduler.schedule(id, ctx.jid, { text: `⏰ Reminder: ${text}` }, minutes * 60 * 1000);
+  await ctx.reply(`✅ Reminder set for ${minutes} minutes`);
+});
+
+// !cancel <id>
+cmd.command('cancel', { ownerOnly: true }, async (ctx) => {
+  const id = ctx.args[0];
+  if (scheduler.cancel(id)) {
+    await ctx.reply(`✅ Cancelled: ${id}`);
+  } else {
+    await ctx.reply('❌ Not found');
+  }
+});
+
+cmd.attach();
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kangwifi-pro/waliwa",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "WhatsApp library based on Baileys 7 + zaileys + baileys-mbuilder. Super lightweight with MessageBuilder, CommandSystem, Automation, Plugin system, Media/Sticker helpers.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -44,6 +44,7 @@
   },
   "files": [
     "dist/**/*",
+    "docs/**/*",
     "README.md",
     "LICENSE"
   ],