@itsliaaa/starcore 0.0.0-alpha.1 → 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,11 +32,13 @@
 ### 📌 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.
 
@@ -47,9 +49,13 @@ Built with a focus on simplicity, and better compatibility with modern WhatsApp
    - [📄 Via `package.json`](#-via-packagejson)
    - [⌨️ Via terminal](#%EF%B8%8F-via-terminal)
    - [🧩 Import (ESM & CJS)](#-import-esm--cjs)
-- [📄 Quick Step](#-quick-step)
+- [📄 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)
@@ -61,12 +67,12 @@ Built with a focus on simplicity, and better compatibility with modern WhatsApp
    - [📦 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)
-   - [📊 Poll](#-poll)
-   - [📈 Poll Result](#-poll-result)
    - [✨ Rich](#-rich)
    - [🗒️ Copy & Forward](#%EF%B8%8F-copy--forward)
    - [🎞️ Status Mention](#%EF%B8%8F-status-mention)
@@ -84,6 +90,9 @@ Built with a focus on simplicity, and better compatibility with modern WhatsApp
    - [🔐 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)
@@ -91,17 +100,24 @@ Built with a focus on simplicity, and better compatibility with modern WhatsApp
 
 ### 📥 Installations
 
+> [!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"
+   "@itsliaaa/starcore": "latest",
+   "baileys": "^7.0.0-rc13"
 }
 
 # GitHub
 "dependencies": {
-   "@itsliaaa/starcore": "github:itsliaaa/starcore"
+   "@itsliaaa/starcore": "github:itsliaaa/starcore",
+   "baileys": "^7.0.0-rc13"
 }
 ```
 
@@ -109,10 +125,10 @@ Built with a focus on simplicity, and better compatibility with modern WhatsApp
 
 ```bash
 # NPM
-npm i @itsliaaa/starcore@latest
+npm i @itsliaaa/starcore@latest baileys@7.0.0-rc13
 
 # GitHub
-npm i github:itsliaaa/starcore
+npm i @itsliaaa/starcore@github:itsliaaa/starcore baileys@7.0.0-rc13
 ```
 
 #### 🧩 Import (ESM & CJS)
@@ -125,7 +141,7 @@ import { Client } from '@itsliaaa/starcore'
 const { Client } = require('@itsliaaa/starcore')
 ```
 
-### 📄 Quick Step
+### 📄 Quick Start
 
 ```javascript
 import { Client } from '@itsliaaa/starcore'
@@ -163,21 +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',
+   watchPath: './plugins', // Default: null
    updatePresence: true, // Default: true
-   updateProtoOnStartup: 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) =>
@@ -185,6 +201,63 @@ 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
@@ -198,11 +271,91 @@ 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.
@@ -231,7 +384,7 @@ const result = sock.findUserId(jidLid)
 #### 🔠 Text
 
 ```javascript
-sock.sendText(jid, '👋🏻 Hello', message, {
+sock.sendText(jid, '👋🏻 Hello', m, {
    mentionAll: false, // Optional
    mentions: ['1211111111111@lid', '6281111111111@s.whatsapp.net'], // Optional
 })
@@ -240,7 +393,7 @@ sock.sendText(jid, '👋🏻 Hello', message, {
 #### 📰 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',
@@ -249,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'),
@@ -265,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
@@ -283,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
@@ -328,7 +481,7 @@ sock.sendContact(jid, [{
    location: 'Jakarta',
    other: '❤️ Simplified WhatsApp API',
    number: '6281111111111'
-}], message)
+}], m)
 ```
 
 #### 🖼️ Album
@@ -340,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
@@ -359,7 +558,8 @@ sock.sendInteractive(jid, [{
 }, {
    text: '🌐 Source',
    url: 'https://www.npmjs.com/package/@itsliaaa/starcore',
-   useWebview: true // Optional
+   useWebView: true, // Optional
+   webViewPresentation: null // Optional
 }, {
    text: '📋 Select',
    sections: [{
@@ -381,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
@@ -437,7 +639,7 @@ sock.sendCarousel(jid, [{
       text: '🌐 Source',
       url: 'https://www.npmjs.com/package/@itsliaaa/starcore'
    }]
-}], message, {
+}], m, {
    text: '🎠 Carousel Message',
    footer: '@itsliaaa/starcore'
 })
@@ -450,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
@@ -480,7 +682,7 @@ sock.sendLegacyButton(jid, [{
          id: '#CouponCode'
       }]
    }]
-}], message, {
+}], m, {
    media: bufferOrUrl,
    caption: '👆🏻 Buttons and List!',
    footer: '@itsliaaa/starcore'
@@ -493,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: [{
@@ -507,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
@@ -700,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()'
 })
@@ -709,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
 })
 ```
 
@@ -722,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: {
@@ -739,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',
@@ -754,7 +941,7 @@ sock.sendGroupStatus(jid, {
 
 ```javascript
 sock.sendMessage(jid, {
-   delete: message.key
+   delete: m.key
 })
 ```
 
@@ -764,13 +951,13 @@ sock.sendMessage(jid, {
 // --- Edit plain text
 sock.sendMessage(jid, {
    text: '✨ I mean, nice!',
-   edit: message.key
+   edit: m.key
 })
 
 // --- Edit media messages caption
 sock.sendMessage(jid, {
    caption: '✨ I mean, here is the image!',
-   edit: message.key
+   edit: m.key
 })
 ```
 
@@ -868,7 +1055,6 @@ console.dir(metadata, { depth: null })
 const inviteCode = await sock.groupInviteCode(jid)
 console.dir(inviteCode, { depth: null })
 
-
 // --- Revoke invite link
 sock.groupRevokeInvite(jid)
 
@@ -1063,7 +1249,7 @@ sock.sendPresenceUpdate('available', jid)
 sock.presenceSubscribe(jid)
 
 // --- Read receipts
-sock.readMessages([message.key])
+sock.readMessages([m.key])
 sock.sendReceipt(jid, participant, [messageId], 'read')
 
 // --- Block user
@@ -1079,8 +1265,8 @@ console.dir(blocked, { depth: null })
 // --- Modify chats
 sock.chatModify({
    archive: true,
-   lastMessageOrig: message,
-   lastMessage: message
+   lastMessageOrig: m,
+   lastMessage: m
 }, jid)
 
 // --- Star messages
@@ -1101,7 +1287,7 @@ sock.keepFavorites([
   '1211111111111@g.us'
 ])
 sock.keepFavorites([
-   '6281111111111@s.whatsapp.net' // only this one remains
+   '6281111111111@s.whatsapp.net' // Only this one remains
 ])
 
 // --- App state sync
@@ -1273,22 +1459,80 @@ 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]
@@ -1333,11 +1577,13 @@ const postResult = await someApi('path/to/post', null, {
 
 ```javascript
 import {
-   Database,
    Client,
+   Database,
+   Extend,
    Request,
    Scraper,
-   Utilities
+   Utilities,
+   Watcher
 } from '@itsliaaa/starcore'
 ```