@yemo-dev/yebail 1.0.0

package/EXAMPLES.md

@@ -0,0 +1,641 @@
+# yebails code examples (`sendMessage`)
+
+GitHub-only distribution. After `npm install` or `npm install github:yemo-dev/baileys`:
+
+```js
+const makeWASocket = require('yebails').default
+```
+
+From a local clone (without global install):
+
+```js
+const makeWASocket = require('./lib').default
+```
+
+Replace `jid` with the target recipient (`628xxx@s.whatsapp.net` or `group@g.us`). All examples assume `const sock = makeWASocket({ ... })` and `await sock.sendMessage(jid, content, options)`.
+
+---
+
+## Authentication & database persistence
+
+yebails supports **local** and **cloud** databases the same way: you choose how `creds` and key bundles are stored. Built-in options:
+
+### 1) Filesystem (default)
+
+```js
+const { default: makeWASocket, useMultiFileAuthState } = require('yebails')
+
+const { state, saveCreds } = await useMultiFileAuthState('./auth_info_baileys')
+const sock = makeWASocket({ auth: state })
+sock.ev.on('creds.update', saveCreds)
+```
+
+### 2) SQLite (single local `.db` file)
+
+Install the optional native driver: `npm install better-sqlite3`
+
+```js
+const { default: makeWASocket, useSqliteAuthState } = require('yebails')
+
+const { state, saveCreds } = await useSqliteAuthState('./wa-session.db')
+const sock = makeWASocket({ auth: state })
+sock.ev.on('creds.update', saveCreds)
+```
+
+### 3) Custom / cloud (Redis, Mongo, HTTP API, etc.)
+
+Implement three async functions: **`get(key)`** → JSON string or `null`, **`set(key, jsonString)`**, **`remove(key)`**. Keys are normalized filenames (e.g. `creds.json`, `pre-key-1.json`).
+
+**Redis (example with `ioredis`):**
+
+```js
+const Redis = require('ioredis')
+const { default: makeWASocket, useCustomAuthState } = require('yebails')
+
+const redis = new Redis(process.env.REDIS_URL)
+const prefix = 'yebails:session:'
+
+const { state, saveCreds } = await useCustomAuthState({
+  get: async (key) => (await redis.get(prefix + key)) ?? null,
+  set: async (key, value) => { await redis.set(prefix + key, value) },
+  remove: async (key) => { await redis.del(prefix + key) }
+})
+
+const sock = makeWASocket({ auth: state })
+sock.ev.on('creds.update', saveCreds)
+```
+
+**Cloud HTTP (sketch):** your backend stores `{ key, value }` rows; `get`/`set`/`remove` call `fetch` to your API. Use TLS, auth headers, and encryption for production.
+
+---
+
+## Plain text
+
+```js
+await sock.sendMessage(jid, { text: 'Hello' })
+```
+
+## Text + quoted reply
+
+```js
+await sock.sendMessage(jid, { text: 'Reply' }, { quoted: fullMessage })
+```
+
+## Text + mention
+
+```js
+await sock.sendMessage(jid, {
+  text: '@6281234567890 hello',
+  mentions: ['6281234567890@s.whatsapp.net']
+})
+```
+
+## Link preview (requires `link-preview-js` in your project + unfurl)
+
+```js
+await sock.sendMessage(jid, { text: 'See https://example.com' })
+```
+
+---
+
+## Legacy buttons (`buttons`)
+
+Mostly works in private chats on many client versions.
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Choose:',
+  footer: 'footer',
+  buttons: [
+    { buttonId: 'id1', buttonText: { displayText: 'One' } },
+    { buttonId: 'id2', buttonText: { displayText: 'Two' } }
+  ]
+})
+```
+
+## List (`sections` / list)
+
+```js
+await sock.sendMessage(jid, {
+  text: 'List description',
+  footer: 'footer',
+  title: 'Title',
+  buttonText: 'Open list',
+  sections: [
+    {
+      title: 'Section A',
+      rows: [
+        { title: 'Option 1', rowId: 'opt1', description: 'desc' },
+        { title: 'Option 2', rowId: 'opt2' }
+      ]
+    }
+  ]
+})
+```
+
+## Template buttons (hydrated)
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Content',
+  footer: 'Footer',
+  templateButtons: [
+    { index: 1, urlButton: { displayText: 'Website', url: 'https://example.com' } },
+    { index: 2, callButton: { displayText: 'Call', phoneNumber: '628xxx' } },
+    { index: 3, quickReplyButton: { displayText: 'OK', id: 'ok' } }
+  ]
+})
+```
+
+---
+
+## Interactive native: quick reply & URL
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Interactive body',
+  title: 'Title',
+  subtitle: 'Subtitle',
+  footer: 'Footer',
+  interactiveButtons: [
+    {
+      name: 'quick_reply',
+      buttonParamsJson: JSON.stringify({ display_text: 'Klik', id: 'btn_1' })
+    },
+    {
+      name: 'cta_url',
+      buttonParamsJson: JSON.stringify({
+        display_text: 'Open link',
+        url: 'https://example.com',
+        merchant_url: 'https://example.com'
+      })
+    }
+  ]
+})
+```
+
+## Interactive: copy code, call, catalog
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Choose an action',
+  footer: 'Footer',
+  interactiveButtons: [
+    {
+      name: 'cta_copy',
+      buttonParamsJson: JSON.stringify({ display_text: 'Salin', copy_code: 'KODE123' })
+    },
+    {
+      name: 'cta_call',
+      buttonParamsJson: JSON.stringify({ display_text: 'Hubungi', phone_number: '6281234567890' })
+    },
+    {
+      name: 'cta_catalog',
+      buttonParamsJson: JSON.stringify({ business_phone_number: '6281234567890' })
+    }
+  ]
+})
+```
+
+## Interactive: PIX payment (`payment_info`)
+
+`text` is still recommended (an empty string is allowed) to keep the payload valid.
+
+```js
+await sock.sendMessage(jid, {
+  text: '',
+  interactiveButtons: [
+    {
+      name: 'payment_info',
+      buttonParamsJson: JSON.stringify({
+        payment_settings: [
+          {
+            type: 'pix_static_code',
+            pix_static_code: {
+              merchant_name: 'Store',
+              key: 'email@domain.com',
+              key_type: 'EMAIL'
+            }
+          }
+        ]
+      })
+    }
+  ]
+})
+```
+
+`key_type` umum: `EMAIL`, `PHONE`, `CPF`, `EVP`.
+
+## Interactive: review & pay (`review_and_pay`)
+
+```js
+await sock.sendMessage(jid, {
+  text: '',
+  interactiveButtons: [
+    {
+      name: 'review_and_pay',
+      buttonParamsJson: JSON.stringify({
+        currency: 'IDR',
+        payment_configuration: '',
+        payment_type: '',
+        total_amount: { value: '100000', offset: '100' },
+        reference_id: 'REF-001',
+        type: 'physical-goods',
+        payment_method: 'confirm',
+        payment_status: 'captured',
+        payment_timestamp: Math.floor(Date.now() / 1000),
+        order: {
+          status: 'completed',
+          description: '',
+          subtotal: { value: '100000', offset: '100' },
+          order_type: 'PAYMENT_REQUEST',
+          items: [
+            {
+              retailer_id: 'sku1',
+              name: 'Product',
+              amount: { value: '100000', offset: '100' },
+              quantity: '1'
+            }
+          ]
+        },
+        additional_note: 'Thank you',
+        native_payment_methods: [],
+        share_payment_status: false
+      })
+    }
+  ]
+})
+```
+
+## Interactive + image / video / document
+
+Add media fields in the same object (document thumbnails are often required).
+
+```js
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/image.jpg' },
+  caption: 'Caption',
+  title: 'Title',
+  subtitle: 'Subtitle',
+  footer: 'Footer',
+  hasMediaAttachment: false,
+  interactiveButtons: [
+    {
+      name: 'quick_reply',
+      buttonParamsJson: JSON.stringify({ display_text: 'OK', id: 'ok' })
+    }
+  ]
+})
+```
+
+## Interactive: single select (single-choice menu)
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Pick one',
+  footer: 'Footer',
+  interactiveButtons: [
+    {
+      name: 'single_select',
+      buttonParamsJson: JSON.stringify({
+        title: 'Menu',
+        sections: [
+          {
+            title: 'Option group',
+            highlight_label: 'Options',
+            rows: [
+              { header: 'A', title: 'One', description: 'Description', id: 'id1' },
+              { header: 'B', title: 'Two', description: '', id: 'id2' }
+            ]
+          }
+        ]
+      })
+    }
+  ]
+})
+```
+
+## Interactive: native flow (galaxy / flow - adjust token and flow id for your business)
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Open flow',
+  footer: 'Footer',
+  interactiveButtons: [
+    {
+      name: 'galaxy_message',
+      buttonParamsJson: JSON.stringify({
+        mode: 'published',
+        flow_message_version: '3',
+        flow_token: '1:xxx:hash',
+        flow_id: '1307913409923914',
+        flow_cta: 'Start',
+        flow_action: 'navigate',
+        flow_action_payload: {
+          screen: 'SCREEN_ONE',
+          params: { user_id: '123' }
+        },
+        flow_metadata: {
+          flow_json_version: '201',
+          data_api_protocol: 'v2',
+          flow_name: 'Lead',
+          data_api_version: 'v2',
+          categories: ['Lead Generation']
+        }
+      })
+    }
+  ]
+})
+```
+
+## Interactive: address, location, webview (button names must match protocol)
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Action',
+  interactiveButtons: [
+    {
+      name: 'address_message',
+      buttonParamsJson: JSON.stringify({ display_text: 'Address' })
+    },
+    {
+      name: 'send_location',
+      buttonParamsJson: JSON.stringify({ display_text: 'Send location' })
+    },
+    {
+      name: 'open_webview',
+      buttonParamsJson: JSON.stringify({
+        title: 'Open',
+        link: { in_app_webview: true, url: 'https://example.com' }
+      })
+    }
+  ]
+})
+```
+
+## Shop storefront (`shop` + `id`)
+
+```js
+await sock.sendMessage(jid, {
+  text: 'View catalog',
+  title: 'Title',
+  subtitle: 'Subtitle',
+  footer: 'Footer',
+  shop: { surface: 1, id: 'https://example.com' },
+  viewOnce: true
+})
+```
+
+---
+
+## Image / video / audio / sticker / document
+
+```js
+await sock.sendMessage(jid, { image: { url: 'https://...' }, caption: '...' })
+await sock.sendMessage(jid, { video: { url: 'https://...' }, caption: '...' })
+await sock.sendMessage(jid, { audio: { url: 'https://...' }, mimetype: 'audio/mp4', ptt: true })
+await sock.sendMessage(jid, { sticker: Buffer.from(...) })
+await sock.sendMessage(jid, { document: { url: 'https://...' }, mimetype: 'application/pdf', fileName: 'a.pdf' })
+```
+
+## GIF (video + flag)
+
+```js
+await sock.sendMessage(jid, { video: bufferOrUrl, gifPlayback: true, caption: 'gif' })
+```
+
+## PTV (round video)
+
+```js
+await sock.sendMessage(jid, { video: { url: '...' }, ptv: true })
+```
+
+## View once
+
+```js
+await sock.sendMessage(jid, { image: { url: '...' }, viewOnce: true })
+```
+
+## Album
+
+```js
+await sock.sendMessage(jid, {
+  album: [
+    { image: { url: '...' }, caption: '1' },
+    { video: { url: '...' }, caption: '2' }
+  ]
+})
+```
+
+---
+
+## Location
+
+```js
+await sock.sendMessage(jid, {
+  location: { degreesLatitude: -6.2, degreesLongitude: 106.8, name: 'Jakarta' }
+})
+```
+
+## Contact (vCard)
+
+```js
+const vcard = 'BEGIN:VCARD\nVERSION:3.0\nFN:Name\nTEL;type=CELL;waid=6281234567890:+62 812-3456-7890\nEND:VCARD'
+await sock.sendMessage(jid, {
+  contacts: { displayName: 'Contact', contacts: [{ vcard }] }
+})
+```
+
+## Reaction
+
+```js
+await sock.sendMessage(jid, { react: { text: ':thumbs_up:', key: messageKey } })
+```
+
+## Delete for everyone
+
+```js
+await sock.sendMessage(jid, { delete: msg.key })
+```
+
+## Edit message
+
+```js
+await sock.sendMessage(jid, { text: 'New text', edit: messageKey })
+```
+
+## Forward
+
+```js
+await sock.sendMessage(jid, { forward: fullMessage, force: true })
+```
+
+## Disappearing messages in chat
+
+```js
+await sock.sendMessage(jid, { disappearingMessagesInChat: true })
+await sock.sendMessage(jid, { text: 'one-time', ephemeralExpiration: 86400 })
+```
+
+## Poll
+
+```js
+await sock.sendMessage(jid, {
+  poll: {
+    name: 'Options',
+    values: ['A', 'B'],
+    selectableCount: 1,
+    toAnnouncementGroup: false
+  }
+})
+```
+
+## Event (schedule)
+
+```js
+await sock.sendMessage(jid, {
+  event: {
+    isCanceled: false,
+    name: 'Meeting',
+    description: 'Description',
+    location: { degreesLatitude: 0, degreesLongitude: 0, name: 'Online' },
+    call: 'audio',
+    startTime: Math.floor(Date.now() / 1000),
+    endTime: Math.floor(Date.now() / 1000) + 3600,
+    extraGuestsAllowed: true
+  }
+})
+```
+
+## Order / product (business catalog)
+
+```js
+await sock.sendMessage(jid, {
+  order: {
+    id: 'id-pesanan',
+    thumbnail: bufferOrUrl,
+    itemCount: '1',
+    status: 'INQUIRY',
+    surface: 'CATALOG',
+    text: 'Buyer note',
+    title: 'Order title',
+    seller: '628xxx@s.whatsapp.net',
+    token: 'token',
+    amount: '100000',
+    currency: 'IDR'
+  }
+})
+
+await sock.sendMessage(jid, {
+  product: {
+    productImage: { url: '...' },
+    productId: 'id',
+    title: 'Product',
+    description: 'Description',
+    currencyCode: 'IDR',
+    priceAmount1000: '50000',
+    retailerId: 'store',
+    url: 'https://...',
+    productImageCount: 1
+  },
+  businessOwnerJid: '628xxx@s.whatsapp.net'
+})
+```
+
+## Group invite
+
+```js
+await sock.sendMessage(jid, {
+  groupInvite: {
+    jid: '123@g.us',
+    subject: 'Group name',
+    text: 'Join us',
+    inviteCode: 'kode',
+    inviteExpiration: 86400,
+    jpegThumbnail: optionalBuffer
+  }
+})
+```
+
+## Payment invite / request payment
+
+```js
+await sock.sendMessage(jid, { paymentInvite: { type: 1, expiry: 0 } })
+
+await sock.sendMessage(jid, {
+  requestPayment: {
+    note: 'Pay',
+    currency: 'IDR',
+    amount: '50000',
+    from: '628xxx@s.whatsapp.net',
+    expiry: 0
+  }
+})
+```
+
+## Pin / keep in chat
+
+```js
+await sock.sendMessage(jid, { pin: { type: 1, time: 86400, key: messageKey } })
+await sock.sendMessage(jid, { keep: { key: messageKey, type: 1 } })
+```
+
+## Scheduled call (message stub)
+
+```js
+await sock.sendMessage(jid, { call: { title: 'Call', type: 1, time: Date.now() } })
+```
+
+## Newsletter admin invite
+
+```js
+await sock.sendMessage(jid, {
+  inviteAdmin: {
+    jid: 'xxx@newsletter',
+    subject: 'Channel',
+    text: 'Become admin',
+    inviteExpiration: 86400,
+    thumbnail: optionalBuffer
+  }
+})
+```
+
+## Phone number (protocol)
+
+```js
+await sock.sendMessage(jid, { sharePhoneNumber: {} })
+await sock.sendMessage(jid, { requestPhoneNumber: {} })
+```
+
+## Button/list reply (as user)
+
+```js
+await sock.sendMessage(jid, {
+  buttonReply: { displayText: 'Yes', id: 'yes' },
+  type: 'plain'
+})
+
+await sock.sendMessage(jid, {
+  buttonReply: { name: 'Row', description: 'Description', rowId: 'r1' },
+  type: 'list'
+})
+
+await sock.sendMessage(jid, {
+  buttonReply: { displayText: 'Template', id: 'x', index: '0' },
+  type: 'template'
+})
+```
+
+## AI marker (send option)
+
+```js
+await sock.sendMessage(jid, { text: 'Hello' }, { ai: true })
+```
+
+---
+
+## Notes
+
+- Native button names (`name` in `interactiveButtons`) must match what the server expects; the examples above follow common Baileys patterns.
+- Some message types are only stable in private chats or only available for business accounts.
+- For `relayMessage` with an AI flag, use uppercase `AI: true` according to your socket implementation.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 yemo-dev / yebails contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.