@itsliaaa/starcore 0.0.0-alpha.0 → 0.0.0-alpha.10

package/README.md

@@ -15,7 +15,7 @@
       <img src="https://img.shields.io/github/stars/itsliaaa/starcore?style=for-the-badge&logo=github"/>
    </a>
    <a href="LICENSE">
-      <img src="https://img.shields.io/badge/license-AGPL--3.0-blue?style=for-the-badge"/>
+      <img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=for-the-badge"/>
    </a>
    <a href="https://nodejs.org">
       <img src="https://img.shields.io/badge/node-%3E%3D20-339933?logo=node.js&labelColor=green&logoColor=white&style=for-the-badge"/>
@@ -32,23 +32,116 @@
 ### 📌 Highlights
 
 - Improved `createParticipantNodes()` by introducing yielding, preventing potential freezes during participant node generation.
-- Enhanced `relayMessage()` with newsletter support and compatibility for sending several important binary payloads.
-- Adapted `prepareWAMessageMedia()` to fully support media delivery to newsletters.
+- Enhanced `relayMessage()` with newsletter support and compatibility for sending additional binary payloads.
+- Adapted `prepareWAMessageMedia()` to support media delivery to newsletters.
 - Added support for sending `stickerPackMessage` through `sendStickerPack()`.
-- Extended support for multiple interactive messages and button-based message types.
-- Introduced `newsletterSubscribed()` to easily retrieve data from all newsletters the account is currently subscribed to.
+- Extended support for multiple interactive and button-based message types.
+- Introduced `newsletterSubscribed()` to retrieve information about all newsletters the account is currently subscribed to.
+- `secretEncryptedMessage` is transparently decrypted into `editedMessage`.
+- `vote` in `pollUpdateMessage` is transparently decrypted to reveal the user's selected poll option(s).
 
 Built with a focus on simplicity, and better compatibility with modern WhatsApp features.
 
-### 🌱 Future Plans
+### 📋 Table of Contents
+
+- [📌 Highlights](#-highlights)
+- [📥 Installations](#-installations)
+   - [📄 Via `package.json`](#-via-packagejson)
+   - [⌨️ Via terminal](#%EF%B8%8F-via-terminal)
+   - [🧩 Import (ESM & CJS)](#-import-esm--cjs)
+- [📄 Quick Start](#-quick-start)
+- [⚙️ Advanced Usage](#%EF%B8%8F-advanced-usage)
+   - [🧳 Environments](#-environments)
+   - [🗄️ Managing Store](#%EF%B8%8F-store-data)
+   - [🗑️ Temporary Folder](#%EF%B8%8F-temporary-folder)
+- [📡 Events Reference](#-events-reference)
+   - [📄 Message Event Metadata](#-message-event-metadata)
+- [👥 Find User ID](#-find-user-id)
+- [📨 Sending Messages](#-sending-messages)
+   - [🔠 Text](#-text)
+   - [📰 Link Preview](#-link-preview)
+   - [😄 Reaction](#-reaction)
+   - [📂 Media](#-media)
+   - [⚪ PTV](#-ptv)
+   - [📃 Sticker](#-sticker)
+   - [📦 Sticker Pack](#-sticker-pack)
+   - [👤 Contact](#-contact)
+   - [🖼️ Album](#%EF%B8%8F-album)
+   - [📊 Poll](#-poll)
+   - [📈 Poll Result](#-poll-result)
+   - [🗄️ Interactive](#%EF%B8%8F-interactive)
+   - [🎠 Carousel](#-carousel)
+   - [🔘 Legacy Button](#-legacy-button)
+   - [📋 Legacy List](#-legacy-list)
+   - [✨ Rich](#-rich)
+   - [🗒️ Copy & Forward](#%EF%B8%8F-copy--forward)
+   - [🎞️ Status Mention](#%EF%B8%8F-status-mention)
+   - [👥 Group Status](#-group-status)
+- [♻️ Modify Messages](#%EF%B8%8F-modify-messages)
+   - [🗑️ Delete Messages](#%EF%B8%8F-delete-messages)
+   - [✏️ Edit Messages](#%EF%B8%8F-edit-messages)
+- [⚙️ Baileys Features](#%EF%B8%8F-baileys-features)
+   - [🔑 Request Custom Pairing Code](#-request-custom-pairing-code)
+   - [📣 Newsletter Management](#-newsletter-management)
+   - [👥 Group Management](#-group-management)
+   - [👥 Community Management](#-community-management)
+   - [👤 Profile Management](#-profile-management)
+   - [🛒 Business Management](#-business-management)
+   - [🔐 Privacy Management](#-privacy-management)
+   - [📡 Baileys Events Reference](#-baileys-events-reference)
+- [🗳️ Database](#%EF%B8%8F-database)
+   - [📎 JSON](#-json)
+   - [📎 SQLite](#-sqlite)
+- [🧩 Extend](#-extend)
+- [🌐 Request](#-request)
+- [📚 Exported Modules](#-exported-modules)
+- [🚀 Try the Bot](#-try-the-bot)
+- [📣 Credits](#-credits)
+
+### 📥 Installations
 
-For now, the alpha release ships with a built-in JSON adapter for Database, Store, and Auth State.
+> [!IMPORTANT]
+> [`@itsliaaa/starcore`](https://www.npmjs.com/package/@itsliaaa/starcore) does **NOT** install Baileys automatically.
+>
+> You must install a compatible version of Baileys manually before using this package.
+
+#### 📄 Via `package.json`
+
+```json
+# NPM
+"dependencies": {
+   "@itsliaaa/starcore": "latest",
+   "baileys": "^7.0.0-rc13"
+}
+
+# GitHub
+"dependencies": {
+   "@itsliaaa/starcore": "github:itsliaaa/starcore",
+   "baileys": "^7.0.0-rc13"
+}
+```
+
+#### ⌨️ Via terminal
+
+```bash
+# NPM
+npm i @itsliaaa/starcore@latest baileys@7.0.0-rc13
+
+# GitHub
+npm i @itsliaaa/starcore@github:itsliaaa/starcore baileys@7.0.0-rc13
+```
 
-More adapters will join the party in future releases. ✨
+#### 🧩 Import (ESM & CJS)
 
-Until then, JSON remains the recommended choice for development, testing, and lightweight deployments.
+```javascript
+// --- ESM
+import { Client } from '@itsliaaa/starcore'
+
+// --- CJS (tested and working on Node.js 24 ✅)
+const { Client } = require('@itsliaaa/starcore')
+```
 
-### 📄 Basic Usage
+### 📄 Quick Start
 
 ```javascript
 import { Client } from '@itsliaaa/starcore'
@@ -86,22 +179,21 @@ const client = new Client({
       name: 'session',
       pairingCode: true,
       phoneNumber: '6281111111111',
-      customCode: 'starcore'
+      customCode: 'starcore',
+      type: 'json' // 'json' | 'sqlite'
    },
    isBotMessageId: (id) =>
       typeof id === 'string' && id.includes('3EB0'),
-   messageIdPrefix: 'starcore',
-   readMessage: true,
-   updatePresence: true,
-   updateProtoOnStartup: true,
-   autoFollowNewsletter: '1111122222@newsletter', // String | String[] | false
+   messageIdPrefix: 'STARCORE',
+   watchPath: './plugins', // Default: null
+   updatePresence: true, // Default: true
+   updateProtoOnStartup: true, // Default: false
+   autoFollowNewsletter: '1211111111111@newsletter', // String | String[] | false
    newsletterAnnotation: {
-      newsletterJid: '',
-      newsletterName: ''
-   }, // IForwardedNewsletterMessageInfo | false
-   saveStoreInterval: 30 * 60 * 1000, // Default: 30 minutes
-   temporaryFileInterval: 45 * 60 * 1000, // Default: 45 minutes
-   gcInterval: 1.5 * 60 * 60 * 1000 // Default: 1.5 hours
+      newsletterJid: '1211111111111@newsletter',
+      newsletterName: '@itsliaaa/starcore',
+      contentType: 1
+   } // IForwardedNewsletterMessageInfo | false
 }, {
    // Baileys socket configuration
    shouldIgnoreJid: (jid) =>
@@ -109,10 +201,67 @@ const client = new Client({
 })
 ```
 
+#### 🧳 Environments
+
+The following environment variables are used by default. Override them with [`dotenv`](https://www.npmjs.com/package/dotenv) when needed.
+
+```ini
+# .env
+FFMPEG_PATH="ffmpeg"
+TEMPORARY_PATH="temp"
+TZ="Asia/Jakarta"
+```
+
+#### 🗄️ Managing Store
+
+Manually load and save store data.
+
+```javascript
+client.on('ready', ({ store }) => {
+   store.readFromFile()
+
+   setInterval(async () => {
+      try {
+         await store.writeToFile()
+      }
+      catch (error) {
+         console.error('❌ An unexpected error occurred when saving store', ':', error)
+      }
+   }, 600_000)
+})
+```
+
+#### 🗑️ Temporary Folder
+
+Since `0.0.0-alpha.3`, temporary files are no longer cleaned up automatically. Implement your own cleanup routine if required.
+
+```javascript
+import { readdir, unlink } from 'fs/promises'
+import { join } from 'path'
+
+setInterval(async () => {
+   try {
+      const temporaryFiles = await readdir(process.env.TEMPORARY_PATH)
+
+      if (temporaryFiles.length) {
+         for (const fileName of temporaryFiles) {
+            const filePath = join(process.env.TEMPORARY_PATH, fileName)
+            await unlink(filePath)
+         }
+      }
+
+      console.log('🗑️ Cleaned up temp folder')
+   }
+   catch (error) {
+      console.error('❌ Failed to clean temp folder', ':', error)
+   }
+}, 300_000)
+```
+
 ### 📡 Events Reference
 
 ```javascript
-client.once('ready', console.log)
+client.on('ready', console.log)
 client.on('message', console.log)
 client.on('message.edit', console.log)
 client.on('message.delete', console.log)
@@ -122,30 +271,110 @@ client.on('group.add', console.log)
 client.on('group.promote', console.log)
 client.on('group.demote', console.log)
 client.on('group.remove', console.log)
+client.on('group.request', console.log)
 client.on('label.update', console.log)
 client.on('caller', console.log)
 client.on('presence', console.log)
 ```
 
+#### 📄 Message Event Metadata
+
+The following example shows the payload received from the `message` event.
+
+This event is the primary source of incoming messages and includes commonly used information such as chat ID, sender, message type, quoted message, mentions, and helper methods.
+
+```javascript
+{
+  m: {
+    key: {
+      remoteJid: '120111111111111111@g.us',
+      remoteJidAlt: undefined,
+      remoteJidUsername: undefined,
+      fromMe: false,
+      id: 'AC1908CA012689BB9F468E6B4478EBAB',
+      participant: '1211111111111@lid',
+      participantAlt: '6281111111111@s.whatsapp.net',
+      participantUsername: undefined,
+      addressingMode: 'lid'
+    },
+    category: undefined,
+    messageTimestamp: 1782264500,
+    pushName: '‏liaaa',
+    broadcast: false,
+    message: Message {
+      extendedTextMessage: [ExtendedTextMessage],
+      messageContextInfo: [MessageContextInfo]
+    },
+    id: 'AC1908CA012689BB9F468E6B4478EBAB',
+    chat: '120111111111111111@g.us',
+    sender: '6281111111111@s.whatsapp.net',
+    senderLid: '1211111111111@lid',
+    device: 'android',
+    fromMe: false,
+    isBot: false,
+    isGroup: true,
+    type: 'extendedTextMessage',
+    msg: ExtendedTextMessage {
+      endCardTiles: [],
+      text: '@itsliaaa/starcore',
+      previewType: 0,
+      contextInfo: [ContextInfo],
+      inviteLinkGroupTypeV2: 0
+    },
+    quoted: {
+      text: '@itsliaaa/starcore',
+      contextInfo: [ContextInfo],
+      id: 'AC15B9E93FABF8C9EA230B9093D57OCR',
+      chat: '120111111111111111@g.us',
+      sender: '6281111111111@s.whatsapp.net',
+      senderLid: '1211111111111@lid',
+      device: 'android',
+      fromMe: false,
+      isBot: false,
+      isGroup: true,
+      type: 'conversation',
+      body: '@itsliaaa/starcore',
+      pushName: '‏liaaa',
+      fakeObj: [Object],
+      mentionedJid: [],
+      expiration: 86400,
+      reply: [Function (anonymous)],
+      react: [Function (anonymous)]
+    },
+    body: '@itsliaaa/starcore',
+    mentionedJid: [],
+    expiration: 86400,
+    reply: [Function (anonymous)],
+    react: [Function (anonymous)]
+  },
+  body: '@itsliaaa/starcore',
+  prefixes: [ '.', '#', '/', '!' ],
+  prefix: '',
+  command: '@itsliaaa/starcore',
+  args: [],
+  text: ''
+}
+```
+
 ### 👥 Find User ID
 
 Quickly resolve a user's `JID` and retrieve both `PN` and `LID` in a synchronous function.
 
 ```javascript
 // Accepts either @s.whatsapp.net or @lid
-const jidLid = '621111111111@s.whatsapp.net'
+const jidLid = '6281111111111@s.whatsapp.net'
 
 const result = sock.findUserId(jidLid)
 
 // --- Success
 // {
-//    phoneNumber: '621111111111@s.whatsapp.net',
-//    lid: '121111111111@lid'
+//    phoneNumber: '6281111111111@s.whatsapp.net',
+//    lid: '1211111111111@lid'
 // }
 
 // --- Not found
 // {
-//    phoneNumber: '621111111111@s.whatsapp.net',
+//    phoneNumber: '6281111111111@s.whatsapp.net',
 //    lid: undefined // or null
 // }
 ```
@@ -155,16 +384,16 @@ const result = sock.findUserId(jidLid)
 #### 🔠 Text
 
 ```javascript
-sock.sendText(jid, '👋🏻 Hello', message, {
+sock.sendText(jid, '👋🏻 Hello', m, {
    mentionAll: false, // Optional
-   mentions: ['621111111111@lid', '621111111111@s.whatsapp.net'], // Optional
+   mentions: ['1211111111111@lid', '6281111111111@s.whatsapp.net'], // Optional
 })
 ```
 
 #### 📰 Link Preview
 
 ```javascript
-sock.sendAdText(jid, '👆🏻 Check it out!', message, {
+sock.sendAdText(jid, '👆🏻 Check it out!', m, {
    thumbnailUrl: 'https://www.npmjs.com/package/@itsliaaa/starcore#readme',
    title: '🌱 @itsliaaa/starcore',
    description: 'Underrated Baileys Wrapper',
@@ -173,9 +402,9 @@ sock.sendAdText(jid, '👆🏻 Check it out!', message, {
 })
 
 // --- Send a text message with a large link preview and favicon
-sock.sendAdText(jid, '👆🏻 Check it out!', message, {
+sock.sendAdText(jid, '👆🏻 Check it out!', m, {
    thumbnailUrl: 'https://www.npmjs.com/package/@itsliaaa/starcore#readme',
-   title: '🌱 @itsliaaa/starcore',
+   title: '✨ @itsliaaa/starcore',
    description: 'Underrated Baileys Wrapper',
    previewType: 0,
    thumbnail: fs.readFileSync('./path/to/image.jpg'),
@@ -189,13 +418,13 @@ sock.sendAdText(jid, '👆🏻 Check it out!', message, {
 #### 😄 Reaction
 
 ```javascript
-sock.sendReact(jid, '✨', message.key)
+sock.sendReact(jid, '✨', m.key)
 ```
 
 #### 📂 Media
 
 ```javascript
-sock.sendMedia(jid, bufferOrUrl, message, {
+sock.sendMedia(jid, bufferOrUrl, m, {
    mime: 'image/jpeg', // Optional, will automatically detect the mime
    document: false, // Optional, force send as document
    ptv: false, // Optional, force send as PTV
@@ -207,13 +436,13 @@ sock.sendMedia(jid, bufferOrUrl, message, {
 #### ⚪ PTV
 
 ```javascript
-sock.sendPtv(jid, bufferOrUrl, message)
+sock.sendPtv(jid, bufferOrUrl, m)
 ```
 
 #### 📃 Sticker
 
 ```javascript
-sock.sendSticker(jid, bufferOrUrl, message, {
+sock.sendSticker(jid, bufferOrUrl, m, {
    packName: '@itsliaaa/starcore',
    packPublisher: 'by Lia Wynn 🌱',
    isAiSticker: true, // Optional
@@ -243,7 +472,7 @@ sock.sendContact(jid, [{
    website: 'https://www.npmjs.com/package/@itsliaaa/starcore#readme',
    location: 'Jakarta',
    other: '❤️ Simplified WhatsApp API',
-   number: '621111111111'
+   number: '6281111111111'
 }, {
    name: '❤️ My Big Brother',
    org: '👥 Siblings',
@@ -251,8 +480,8 @@ sock.sendContact(jid, [{
    website: 'https://www.npmjs.com/package/@itsliaaa/starcore#readme',
    location: 'Jakarta',
    other: '❤️ Simplified WhatsApp API',
-   number: '621111111111'
-}], message)
+   number: '6281111111111'
+}], m)
 ```
 
 #### 🖼️ Album
@@ -264,7 +493,53 @@ sock.sendAlbum(jid, [{
 }, {
    media: bufferOrUrl,
    caption: 'Video'
-}], message)
+}], m)
+```
+
+#### 📊 Poll
+
+```javascript
+// --- Regular poll message
+sock.sendPoll(jid, [
+   '✨ Yes', '💀 No'
+], m, {
+   name: '🔥 Is it good?',
+   selectableCount: 1,
+   toAnnouncementGroup: false,
+   endDate: Date.now() + 28_800_000, // Optional
+   hideVoter: false, // Optional
+   canAddOption: false // Optional
+})
+
+// --- Quiz (only for newsletter)
+sock.sendQuiz('1211111111111@newsletter', [
+   '✨ Yes', '💀 No'
+], m, {
+   name: '🔥 Quiz!',
+   correctAnswer: '✨ Yes'
+})
+```
+
+#### 📈 Poll Result
+
+```javascript
+// --- Regular poll result message
+sock.sendPollResult(jid, '📈 Poll Result', [{
+   name: '🔥 Fire',
+   voteCount: 133
+}, {
+   name: '❤️ Love it',
+   voteCount: 18
+}], m)
+
+// --- Quiz result message
+sock.sendQuizResult(jid, '🏆 Quiz Result', [{
+   name: '🔥 Fire',
+   voteCount: 133
+}, {
+   name: '❤️ Love it',
+   voteCount: 18
+}], m)
 ```
 
 #### 🗄️ Interactive
@@ -276,14 +551,15 @@ sock.sendInteractive(jid, [{
    icon: 'review' // Optional
 }, {
    text: '📞 Call',
-   call: '621111111111'
+   call: '6281111111111'
 }, {
    text: '📋 Copy',
    copy: '@itsliaaa/starcore'
 }, {
    text: '🌐 Source',
    url: 'https://www.npmjs.com/package/@itsliaaa/starcore',
-   useWebview: true // Optional
+   useWebView: true, // Optional
+   webViewPresentation: null // Optional
 }, {
    text: '📋 Select',
    sections: [{
@@ -305,10 +581,12 @@ sock.sendInteractive(jid, [{
       }]
    }],
    icon: 'default' // Optional
-}], message, {
+}], m, {
    media: bufferOrUrl,
    caption: '🗄️ Interactive Message',
    footer: '@itsliaaa/starcore',
+   audioFooter: '/path/to/audio.mp3', // Optional
+   ptt: false, // Optional, applied when "audioFooter" is set
    optionText: '👉🏻 Select Options', // Optional, wrap all native flow into a single list
    optionTitle: '📄 Select Options', // Optional
    offerText: '🏷️ Newest Coupon!', // Optional, add an offer into message
@@ -361,7 +639,7 @@ sock.sendCarousel(jid, [{
       text: '🌐 Source',
       url: 'https://www.npmjs.com/package/@itsliaaa/starcore'
    }]
-}], message, {
+}], m, {
    text: '🎠 Carousel Message',
    footer: '@itsliaaa/starcore'
 })
@@ -374,7 +652,7 @@ sock.sendCarousel(jid, [{
 sock.sendLegacyButton(jid, [{
    text: '👋🏻 SignUp',
    id: '#SignUp'
-}], message, {
+}], m, {
    text: '👆🏻 Buttons!',
    footer: '@itsliaaa/starcore',
    viewOnce: false // Optional, change to "true" if want proper render on WhatsApp Web
@@ -404,7 +682,7 @@ sock.sendLegacyButton(jid, [{
          id: '#CouponCode'
       }]
    }]
-}], message, {
+}], m, {
    media: bufferOrUrl,
    caption: '👆🏻 Buttons and List!',
    footer: '@itsliaaa/starcore'
@@ -417,6 +695,7 @@ sock.sendLegacyButton(jid, [{
 > This message is only works in private chat (`@s.whatsapp.net`)
 
 ```javascript
+// --- Regular legacy list message
 sock.sendLegacyList(jid, [{
    title: '🚀 Menu 1',
    rows: [{
@@ -431,58 +710,36 @@ sock.sendLegacyList(jid, [{
       description: '',
       rowId: '#Search'
    }]
-}], message, {
+}], m, {
    text: '📋 List!',
    footer: '@itsliaaa/starcore',
    buttonText: '📋 Select',
    title: '👋🏻 Hello'
 })
-```
-
-#### 📊 Poll
-
-```javascript
-// --- Regular poll message
-sock.sendPoll(jid, [
-   '✨ Yes', '💀 No'
-], message, {
-   name: '🔥 Is it good?',
-   selectableCount: 1,
-   toAnnouncementGroup: false,
-   endDate: new Date(Date.now() + 28_800_000), // Optional
-   hideVoter: false, // Optional
-   canAddOption: false // Optional
-})
-
-// --- Quiz (only for newsletter)
-sock.sendQuiz('1211111111111@newsletter', [
-   '✨ Yes', '💀 No'
-], message, {
-   name: '🔥 Quiz!',
-   correctAnswer: '✨ Yes'
-})
-```
 
-#### 📈 Poll Result
-
-```javascript
-// --- Regular poll result message
-sock.sendPollResult(jid, '📈 Poll Result', [{
-   name: '🔥 Fire',
-   voteCount: 133
-}, {
-   name: '❤️ Love it',
-   voteCount: 18
-}], message)
-
-// --- Quiz result message
-sock.sendQuizResult(jid, '🏆 Quiz Result', [{
-   name: '🔥 Fire',
-   voteCount: 133
+// --- Product list message
+client.sendLegacyList(m.chat, [{
+   title: '📄 Section #1',
+   products: [{
+      productId: '177878345044'
+   }, {
+      productId: '607964531532'
+   }]
 }, {
-   name: '❤️ Love it',
-   voteCount: 18
-}], message)
+   title: '📋 Section #2',
+   products: [{
+      productId: '506965808593'
+   }, {
+      productId: '676909529293'
+   }]
+}], m, {
+   text: '🛍️ Product List!',
+   footer: '@itsliaaa/starcore',
+   buttonText: '📋 See Products',
+   image: bufferOrUrl,
+   headerProductId: '656988410262',
+   businessOwnerJid: '0@s.whatsapp.net'
+})
 ```
 
 #### ✨ Rich
@@ -624,7 +881,7 @@ sock.sendRich(jid, [{
       faviconUrl: 'https://path-to-tiny-image.com/',
       mime: 'image/jpeg' // Optional, the mime type of favicon
    }]
-}], message, {
+}], m, {
    notify: false, // Optional
    disclaimerText: 'Example Usage of sendRich()'
 })
@@ -633,9 +890,9 @@ sock.sendRich(jid, [{
 #### 🗒️ Copy & Forward
 
 ```javascript
-sock.sendCopyMessage(jid, message, {
+sock.sendCopyMessage(jid, m, {
    forwardingScore: 1, // Optional
-   quoted: message // Optional
+   quoted: m // Optional
 })
 ```
 
@@ -646,7 +903,10 @@ sock.sendCopyMessage(jid, message, {
 
 ```javascript
 sock.sendStatus([jid], {
-   text: '👋🏻 Hello!'
+   text: '👋🏻 Hello!',
+   font: 0,
+   textColor: '#FFFFFF', // Optional
+   backgroundColor: '#FF0000' // Optional
 }, {
    mention: false, // Optional
    closeFriends: {
@@ -663,7 +923,10 @@ sock.sendStatus([jid], {
 
 ```javascript
 sock.sendGroupStatus(jid, {
-   text: '👋🏻 Hello!'
+   text: '👋🏻 Hello!',
+   font: 0,
+   textColor: '#FFFFFF', // Optional
+   backgroundColor: '#000000' // Optional
 }, {
    closeFriends: {
       name: '@itsliaaa/starcore',
@@ -672,24 +935,604 @@ sock.sendGroupStatus(jid, {
 })
 ```
 
+### ♻️ Modify Messages
+
+#### 🗑️ Delete Messages
+
+```javascript
+sock.sendMessage(jid, {
+   delete: m.key
+})
+```
+
+#### ✏️ Edit Messages
+
+```javascript
+// --- Edit plain text
+sock.sendMessage(jid, {
+   text: '✨ I mean, nice!',
+   edit: m.key
+})
+
+// --- Edit media messages caption
+sock.sendMessage(jid, {
+   caption: '✨ I mean, here is the image!',
+   edit: m.key
+})
+```
+
+### ⚙️ Baileys Features
+
+#### 🔑 Request Custom Pairing Code
+
+> [!NOTE]
+> The phone number must contain numbers only (no +, (), or -) and must include the country code.
+
+```javascript
+const phoneNumber = '6281111111111'
+const customPairingCode = 'STARCORE'
+
+await sock.requestPairingCode(phoneNumber, customPairingCode)
+
+console.log('🔗 Pairing code', ':', customPairingCode)
+```
+
+#### 📣 Newsletter Management
+
+```javascript
+// --- Create a new one
+sock.newsletterCreate('@itsliaaa/starcore', '📣 Fresh updates weekly')
+
+// --- Get info
+const metadata = sock.newsletterMetadata('1211111111111@newsletter')
+console.dir(metadata, { depth: null })
+
+// --- Get subscribers count
+const subscribers = await sock.newsletterSubscribers('1211111111111@newsletter')
+console.dir(subscribers, { depth: null })
+
+// --- Follow and Unfollow
+sock.newsletterFollow('1211111111111@newsletter')
+sock.newsletterUnfollow('1211111111111@newsletter')
+
+// --- Mute and Unmute
+sock.newsletterMute('1211111111111@newsletter')
+sock.newsletterUnmute('1211111111111@newsletter')
+
+// --- Demote admin
+sock.newsletterDemote('1211111111111@newsletter', '6281111111111@s.whatsapp.net')
+
+// --- Change owner
+sock.newsletterChangeOwner('1211111111111@newsletter', '6281111111111@s.whatsapp.net')
+
+// --- Update newsletter
+sock.newsletterUpdate('1211111111111@newsletter', { name: '@itsliaaa/starcore' })
+
+// --- Change name
+sock.newsletterUpdateName('1211111111111@newsletter', '✨ @itsliaaa/starcore')
+
+// --- Change description
+sock.newsletterUpdateDescription('1211111111111@newsletter', '📣 Fresh updates weekly')
+
+// --- Change photo
+sock.newsletterUpdatePicture('1211111111111@newsletter', {
+   url: 'path/to/image.jpg'
+})
+
+// --- Remove photo
+sock.newsletterRemovePicture('1211111111111@newsletter')
+
+// --- React to a message
+sock.newsletterReactMessage('1211111111111@newsletter', '100', '💛')
+
+// --- Get admin count
+const count = await sock.newsletterAdminCount('1211111111111@newsletter')
+
+// --- Get all subscribed newsletters
+const newsletters = await sock.newsletterSubscribed()
+console.dir(newsletters, { depth: null })
+
+// --- Fetch newsletter messages
+const messages = sock.newsletterFetchMessages('jid', '1211111111111@newsletter', 50, 0, 0)
+console.dir(messages, { depth: null })
+
+// --- Delete newsletter
+sock.newsletterDelete('1211111111111@newsletter')
+```
+
+#### 👥 Group Management
+
+```javascript
+// --- Create a new one and add participants using their JIDs
+const group = sock.groupCreate('@itsliaaa/starcore', ['6281111111111@s.whatsapp.net'])
+console.dir(group, { depth: null })
+
+// --- Get info
+const metadata = await sock.groupMetadata(jid)
+console.dir(metadata, { depth: null })
+
+// --- Get group invite code
+const inviteCode = await sock.groupInviteCode(jid)
+console.dir(inviteCode, { depth: null })
+
+// --- Revoke invite link
+sock.groupRevokeInvite(jid)
+
+// --- Accept group invite
+sock.groupAcceptInvite(inviteCode)
+
+// --- Leave group
+sock.groupLeave(jid)
+
+// --- Add participants
+sock.groupParticipantsUpdate(jid, ['6281111111111@s.whatsapp.net'], 'add')
+
+// --- Remove participants
+sock.groupParticipantsUpdate(jid, ['6281111111111@s.whatsapp.net'], 'remove')
+
+// --- Promote to admin
+sock.groupParticipantsUpdate(jid, ['6281111111111@s.whatsapp.net'], 'promote')
+
+// --- Demote from admin
+sock.groupParticipantsUpdate(jid, ['6281111111111@s.whatsapp.net'], 'demote')
+
+// --- Accept join requests
+sock.groupRequestParticipantsUpdate(jid, ['6281111111111@s.whatsapp.net'], 'approve')
+
+// --- Change name
+sock.groupUpdateSubject(jid, '✨ @itsliaaa/starcore')
+
+// --- Change description
+sock.groupUpdateDescription(jid, 'Updated description')
+
+// --- Change photo
+sock.updateProfilePicture(jid, {
+   url: 'path/to/image.jpg'
+})
+
+// --- Remove photo
+sock.removeProfilePicture(jid)
+
+// --- Set group as admin only for chatting
+sock.groupSettingUpdate(jid, 'announcement')
+
+// --- Set group as open to all for chatting
+sock.groupSettingUpdate(jid, 'not_announcement')
+
+// --- Set admin only can edit group info
+sock.groupSettingUpdate(jid, 'locked')
+
+// --- Set all participants can edit group info
+sock.groupSettingUpdate(jid, 'unlocked')
+
+// --- Set admin only can add participants
+sock.groupMemberAddMode(jid, 'admin_add')
+
+// --- Set all participants can add participants
+sock.groupMemberAddMode(jid, 'all_member_add')
+
+// --- Enable or disable temporary messages with seconds format
+sock.groupToggleEphemeral(jid, 86400)
+
+// --- Disable temporary messages
+sock.groupToggleEphemeral(jid, 0)
+
+// --- Enable or disable membership approval mode
+sock.groupJoinApprovalMode(jid, 'on')
+sock.groupJoinApprovalMode(jid, 'off')
+
+// --- Get all groups metadata
+const groups = await sock.groupFetchAllParticipating()
+console.dir(groups, { depth: null })
+
+// --- Get pending join requests
+const requests = await sock.groupRequestParticipantsList(jid)
+console.dir(requests, { depth: null })
+
+// --- Get group info from link
+const group = await sock.groupGetInviteInfo('ABC123456789')
+console.log('👥 Got group info from invite code', ':', group)
+
+// --- Update bot member label
+sock.updateMemberLabel(jid, '@itsliaaa/starcore')
+```
+
+#### 👥 Community Management
+
+```javascript
+// --- Create a new one and add description
+const community = await sock.communityCreate('@itsliaaa/starcore', '📣 Fresh updates weekly')
+console.dir(community, { depth: null })
+
+// --- Create a subgroup for community and add participants using their JIDs
+const group = await sock.communityCreateGroup('📢 Announcements', ['6281111111111@s.whatsapp.net'], communityJid)
+
+// --- Link an existing group
+sock.communityLinkGroup(groupJid, communityJid)
+
+// --- Unlink an existing group
+sock.communityUnlinkGroup(groupJid, communityJid)
+
+// --- Get info
+const metadata = await sock.communityMetadata(jid)
+console.dir(metadata, { depth: null })
+
+// --- Get community invite code
+const inviteCode = await sock.communityInviteCode(jid)
+console.dir(inviteCode, { depth: null })
+
+// --- Revoke invite link
+sock.communityRevokeInvite(jid)
+
+// --- Accept community invite
+sock.communityAcceptInvite(inviteCode)
+
+// --- Leave community
+sock.communityLeave(jid)
+
+// --- Accept join requests
+sock.communityRequestParticipantsUpdate(jid, ['6281111111111@s.whatsapp.net'], 'approve')
+
+// --- Change name
+sock.communityUpdateSubject(jid, '✨ @itsliaaa/starcore')
+
+// --- Change description
+sock.communityUpdateDescription(jid, 'Updated description')
+
+// --- Set community as admin only for chatting
+sock.communitySettingUpdate(jid, 'announcement')
+
+// --- Set community as open to all for chatting
+sock.communitySettingUpdate(jid, 'not_announcement')
+
+// --- Set admin only can edit community info
+sock.communitySettingUpdate(jid, 'locked')
+
+// --- Set all participants can edit community info
+sock.communitySettingUpdate(jid, 'unlocked')
+
+// --- Set admin only can add participants
+sock.communityMemberAddMode(jid, 'admin_add')
+
+// --- Set all participants can add participants
+sock.communityMemberAddMode(jid, 'all_member_add')
+
+// --- Enable or disable temporary messages with seconds format
+sock.communityToggleEphemeral(jid, 86400)
+
+// --- Disable temporary messages
+sock.communityToggleEphemeral(jid, 0)
+
+// --- Enable or disable membership approval mode
+sock.communityJoinApprovalMode(jid, 'on')
+sock.communityJoinApprovalMode(jid, 'off')
+
+// --- Get all communities metadata
+const communities = await sock.communityFetchAllParticipating()
+console.dir(communities, { depth: null })
+
+// --- Get all community linked groups
+const linked = await sock.communityFetchLinkedGroups(jid)
+console.dir(linked, { depth: null })
+
+// --- Get pending join requests
+const requests = await sock.communityRequestParticipantsList(jid)
+console.dir(requests, { depth: null })
+
+// --- Get community info from link
+const community = await sock.communityGetInviteInfo('ABC123456789')
+console.log('👥 Got community info from invite code', ':', community)
+```
+
+#### 👤 Profile Management
+
+```javascript
+// --- Get user profile picture
+const url = await sock.profilePictureUrl(jid, 'image')
+console.log('🖼️ Got user profile url', url)
+
+// --- Update profile picture
+sock.updateProfilePicture(jid, buffer)
+sock.updateProfilePicture(jid, { url })
+
+// --- Remove profile picture
+sock.removeProfilePicture(jid)
+
+// --- Update profile name
+sock.updateProfileName('My Name')
+
+// --- Update profile status
+sock.updateProfileStatus('Available')
+
+// --- Presence
+sock.sendPresenceUpdate('available', jid)
+sock.presenceSubscribe(jid)
+
+// --- Read receipts
+sock.readMessages([m.key])
+sock.sendReceipt(jid, participant, [messageId], 'read')
+
+// --- Block user
+sock.updateBlockStatus(jid, 'block')
+
+// --- Unblock user
+sock.updateBlockStatus(jid, 'unblock')
+
+// --- Fetch blocklist
+const blocked = await sock.fetchBlocklist()
+console.dir(blocked, { depth: null })
+
+// --- Modify chats
+sock.chatModify({
+   archive: true,
+   lastMessageOrig: m,
+   lastMessage: m
+}, jid)
+
+// --- Star messages
+sock.star(jid, [{ id: messageId, fromMe: true }], true)
+
+// --- Contact
+sock.addOrEditContact(jid, { displayName: 'Starseed' })
+sock.removeContact(jid)
+
+// --- Label
+sock.addChatLabel(jid, labelId)
+sock.removeChatLabel(jid, labelId)
+sock.addMessageLabel(jid, messageId, labelId)
+
+// --- Favorites
+sock.keepFavorites([
+  '6281111111111@s.whatsapp.net',
+  '1211111111111@g.us'
+])
+sock.keepFavorites([
+   '6281111111111@s.whatsapp.net' // Only this one remains
+])
+
+// --- App state sync
+sock.resyncAppState(['regular', 'critical_block'], true)
+
+// --- Get business profile
+const profile = await sock.getBusinessProfile(jid)
+console.dir(profile, { depth: null })
+```
+
+#### 🛒 Business Management
+
+```javascript
+// --- Create a new product
+const product = await sock.productCreate({
+   name: '🧩 Starseed (Premium)',
+   description: 'Get a full version of Starseed!',
+   price: 100000,
+   currency: 'IDR',
+   originCountryCode: 'ID',
+   images: [
+      bufferImage,
+      {
+         url: './path/to/image.jpg'
+      }
+   ]
+})
+console.dir(product, { depth: null })
+
+// --- Update product
+await sock.productUpdate(productId, {
+   name: '🧩 Starseed (Premium)',
+   description: 'Get a full version of Starseed with more features!',
+   price: 75000,
+   currency: 'IDR',
+   images: [
+      {
+         url: './path/to/image.jpg'
+      }
+   ]
+})
+
+// --- Delete product
+sock.productDelete([productId])
+
+// --- Get catalog info
+const { products, nextPageCursor } = await sock.getCatalog({
+  jid: '6281111111111@s.whatsapp.net',
+  limit: 10
+})
+
+// --- Get collections
+const collections = await sock.getCollections('6281111111111@s.whatsapp.net', 10)
+console.dir(collections, { depth: null })
+
+// --- Get order info
+const order = await sock.getOrderDetails(orderId, tokenBase64)
+console.dir(order, { depth: null })
+
+// --- Update business profile
+await sock.updateBusinessProfile({
+   address: 'Jakarta, Indonesia',
+   description: '🛒 Official Starseed Store',
+   websites: ['https://www.npmjs.com/package/@itsliaaa/starcore'],
+   email: 'more-more@gmail.com',
+   hours: {
+      timezone: 'Asia/Jakarta',
+      days: [{ day: 'mon', mode: 'open_24h' }]
+   }
+})
+
+// --- Update cover
+sock.updateCoverPhoto({
+   url: './path/to/image.jpg'
+})
+
+// --- Remove cover
+sock.removeCoverPhoto(coverId)
+
+// --- Update quick replies
+sock.addOrEditQuickReply({
+  shortcut: 'hello',
+  message: 'Hello from business account',
+})
+
+// --- Remove quick reply
+sock.removeQuickReply(timestamp)
+```
+
+#### 🔐 Privacy Management
+
+```javascript
+// --- Update last seen privacy
+sock.updateLastSeenPrivacy('all')
+sock.updateLastSeenPrivacy('contacts')
+sock.updateLastSeenPrivacy('contact_blacklist')
+sock.updateLastSeenPrivacy('nobody')
+
+// --- Update online privacy
+sock.updateOnlinePrivacy('all')
+sock.updateOnlinePrivacy('match_last_seen')
+
+// --- Update profile picture privacy
+sock.updateProfilePicturePrivacy('contacts')
+
+// --- Update status privacy
+sock.updateStatusPrivacy('contacts')
+
+// --- Update read receipts privacy
+sock.updateReadReceiptsPrivacy('all')
+sock.updateReadReceiptsPrivacy('none')
+
+// --- Update groups add privacy
+sock.updateGroupsAddPrivacy('all')
+sock.updateGroupsAddPrivacy('contacts')
+
+// --- Update messages privacy
+sock.updateMessagesPrivacy('all')
+sock.updateMessagesPrivacy('contacts')
+sock.updateMessagesPrivacy('nobody')
+
+// --- Update call privacy
+sock.updateCallPrivacy('everyone')
+
+// --- Update default disappearing mode
+sock.updateDefaultDisappearingMode(86400)
+
+// --- Update link previews privacy
+sock.updateDisableLinkPreviewsPrivacy(true)
+```
+
+#### 📡 Baileys Events Reference
+
+```javascript
+sock.ev.on('connection.update', console.log)
+sock.ev.on('creds.update', console.log)
+sock.ev.on('messaging-history.set', console.log)
+sock.ev.on('messaging-history.status', console.log)
+sock.ev.on('chats.upsert', console.log)
+sock.ev.on('chats.update', console.log)
+sock.ev.on('chats.delete', console.log)
+sock.ev.on('chats.lock', console.log)
+sock.ev.on('lid-mapping.update', console.log)
+sock.ev.on('presence.update', console.log)
+sock.ev.on('contacts.upsert', console.log)
+sock.ev.on('contacts.update', console.log)
+sock.ev.on('messages.delete', console.log)
+sock.ev.on('messages.update', console.log)
+sock.ev.on('messages.media-update', console.log)
+sock.ev.on('messages.upsert', console.log)
+sock.ev.on('messages.reaction', console.log)
+sock.ev.on('message-receipt.update', console.log)
+sock.ev.on('groups.upsert', console.log)
+sock.ev.on('groups.update', console.log)
+sock.ev.on('group-participants.update', console.log)
+sock.ev.on('group.join-request', console.log)
+sock.ev.on('group.member-tag.update', console.log)
+sock.ev.on('blocklist.set', console.log)
+sock.ev.on('blocklist.update', console.log)
+sock.ev.on('call', console.log)
+sock.ev.on('labels.edit', console.log)
+sock.ev.on('labels.association', console.log)
+sock.ev.on('newsletter.reaction', console.log)
+sock.ev.on('newsletter.view', console.log)
+sock.ev.on('newsletter-participants.update', console.log)
+sock.ev.on('newsletter-settings.update', console.log)
+sock.ev.on('settings.update', console.log)
+```
+
 ### 🗳️ Database
 
-> [!IMPORTANT]
-> Currently, only the JSON adapter is available. Additional adapters are planned for future releases.
+Including two built-in database backends to fit different use cases:
+
+- **JSON**: A lightweight solution for small projects and straightforward data storage.
+- **SQLite**: Powered by `better-sqlite3`, delivering high performance, low overhead, and a hassle-free experience.
+
+#### 📎 JSON
 
 ```javascript
 import { Database } from '@itsliaaa/starcore'
 
-const db = Database.saveToLocal('database.json')
-const data = await db.read('database.json') // Read database from file, will return empty object if not exists
+const db = await Database.json('database.json')
+
+const data = await db.read()
+
 await db.write({
    users: {},
    groups: {},
-   contacts: {},
    settings: {}
-}) // Save data to file
+})
 ```
 
+#### 📎 SQLite
+
+> [!IMPORTANT]
+> [`better-sqlite3@>=12.2.0`](https://www.npmjs.com/package/better-sqlite3) is a peer dependency. You must install it manually and add it to your project's `package.json`.
+
+```javascript
+import { Database } from '@itsliaaa/starcore'
+
+const db = await Database.sqlite('database.db')
+
+const data = db.read()
+
+db.write({
+   users: {},
+   groups: {},
+   settings: {}
+})
+
+db.close()
+```
+
+### 🧩 Extend
+
+If you prefer not to use the `Client` wrapper but still want the additional features provided by this package, you can use `Extend`.
+
+> [!TIP]
+> `sock` is used as the Baileys socket instance throughout this example. If your project uses a different variable name (e.g. `conn` or `client`), replace `sock` with your own variable name.
+
+> [!CAUTION]
+> Your Baileys instance must be extensible and writable, as `Extend` attaches additional methods to the instance.
+
+```javascript
+import { Extend } from '@itsliaaa/starcore'
+import { makeWASocket } from 'baileys'
+
+const sock = makeWASocket({ ... })
+
+await Extend(sock, {
+   messageIdPrefix: 'STARCORE',
+   updatePresence: true, // Default: true
+   autoFollowNewsletter: '1211111111111@newsletter', // String | String[] | false
+   newsletterAnnotation: {
+      newsletterJid: '1211111111111@newsletter',
+      newsletterName: '@itsliaaa/starcore',
+      contentType: 1
+   } // IForwardedNewsletterMessageInfo | false
+})
+
+// sock.sendText(jid, 'Hello there', message)
+```
+
+Besides extending your socket with additional helper methods, `Extend` also provides built-in decryption for `secretEncryptedMessage` to obtain `editedMessage` and automatically decrypts the `vote` payload contained in `pollUpdateMessage`.
+
 ### 🌐 Request
 
 > [!NOTE]
@@ -734,17 +1577,19 @@ const postResult = await someApi('path/to/post', null, {
 
 ```javascript
 import {
-   Database,
    Client,
+   Database,
+   Extend,
    Request,
    Scraper,
-   Utilities
+   Utilities,
+   Watcher
 } from '@itsliaaa/starcore'
 ```
 
 ### 🚀 Try the Bot
 
-A fast, lightweight, and modular WhatsApp bot built with [@itsliaaa/starcore](https://www.npmjs.com/package/@itsliaaa/starcore).
+A fast, lightweight, and modular WhatsApp bot built with [@itsliaaa/baileys](https://www.npmjs.com/package/@itsliaaa/baileys).
 Perfect for managing groups, moderating chats, and adding fun with quiz games and handy tools.
 
 👉🏻 [@itsliaaa/starseed](https://github.com/itsliaaa/starseed#readme)