npm - @codexverified/baileys - Versions diffs - 2.10.12 → 2.12.12 - Mend

@codexverified/baileys 2.10.12 → 2.12.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/README.md +216 -99
package/lib/Socket/index.js +1 -1
package/lib/Socket/messages-send.js +8 -1
package/lib/Utils/ban-checker.js +48 -0
package/lib/Utils/games/slot-machine.js +258 -0
package/lib/Utils/index.js +6 -0
package/lib/Utils/messages.js +1 -0
package/lib/Utils/native-flow.js +48 -0
package/lib/Utils/portable-compat.js +12 -0
package/lib/Utils/rich-message-utils.js +108 -2
package/lib/Utils/view-once-utils.js +56 -0
package/lib/Utils/website-preview.js +27 -0
package/lib/index.d.ts +33 -0
package/lib/index.js +1 -0
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,19 +1,44 @@
 # @codexverified/baileys
+[![npm version](https://img.shields.io/npm/v/@codexverified/baileys.svg)](https://www.npmjs.com/package/@codexverified/baileys)
+[![node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](#at-a-glance)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](#license-and-maintenance)
+[![types](https://img.shields.io/badge/types-included-blue)](#at-a-glance)
 > A readable, carefully maintained Baileys distribution for building reliable WhatsApp integrations with codexverified/baileys.
 `@codexverified/baileys` is a Node.js and TypeScript library for creating WhatsApp automations over the Baileys protocol. It provides a socket-oriented API for authentication, messaging, media, interactive content, rich responses, newsletters, groups, communities, business features, account utilities, and carefully documented extensions.
 The package is maintained by **Codex** under the **CodexVerified** organization. It is intended for developers who want a practical Baileys foundation with familiar interfaces, public TypeScript declarations, readable source code, explicit behavior, and room for carefully tested improvements.
-## At a glance
+## Table of contents
+- [At a glance](#at-a-glance)
+- [Installation](#installation)
+- [Quick start](#quick-start)
+- [CommonJS usage](#commonjs-usage)
+- [Core capabilities](#core-capabilities)
+- [Everyday message usage](#everyday-message-usage)
+- [Rich menu example](#rich-menu-example)
+- [Status, grids, tables, and flows](#status-grids-tables-and-flows)
+- [Authentication and deployment guidance](#authentication-and-deployment-guidance)
+- [Development workflow](#development-workflow)
+- [Recent compatibility updates](#recent-compatibility-updates)
+- [About Codex](#about-codex)
+- [Package layout](#package-layout)
+- [Security and responsible use](#security-and-responsible-use)
+- [License and maintenance](#license-and-maintenance)
+- [Compatibility additions](#compatibility-additions)
+- [Comparison references](#comparison-references)
+- [Additional functional compatibility helpers](#additional-functional-compatibility-helpers)
+- [AI generation primitive](#ai-generation-primitive)
-This release is version **2.10.12**. It uses ECMAScript modules, supports CommonJS usage where the installed Node.js version permits it, ships public TypeScript declarations, and targets Node.js 20 or newer.
+## At a glance
 | Property | Value |
 | --- | --- |
 | Package | `@codexverified/baileys` |
-| Version | `2.10.12` |
+| Version | `2.12.12` |
 | Runtime | Node.js 20 or newer |
 | Module format | ESM, with CommonJS compatibility where supported |
 | Type declarations | Included at `lib/index.d.ts` |
@@ -24,30 +49,18 @@ This release is version **2.10.12**. It uses ECMAScript modules, supports Common
 ## Installation
-Install the package from npm when it is published under your organization:
-```bash
-npm install @codexverified/baileys
-```
-To install a local package archive, place the `.tgz` file beside your application and run:
+| Method | Command | Notes |
+| --- | --- | --- |
+| From npm | `npm install @codexverified/baileys` | Standard install when published under your organization |
+| From local archive | `npm install ./codex-baileys-2.12.12.tgz` | Place the `.tgz` beside your application |
+| Source audit (no scripts) | `npm install --ignore-scripts` | Skips install hooks for local review |
-```bash
-npm install ./codex-baileys-2.10.12.tgz
-```
-Both installation methods use the same import name:
+Both npm and archive installs use the same import name:
 ```javascript
 import { makeWASocket } from '@codexverified/baileys'
 ```
-For local source auditing, install dependencies without executing package installation hooks:
-```bash
-npm install --ignore-scripts
-```
 ## Quick start
 The following example creates a socket, stores multi-file authentication credentials, reconnects after an unexpected disconnect, and replies to incoming messages. Keep the session directory private and never commit it to a public repository.
@@ -99,8 +112,6 @@ start().catch(console.error)
 ## CommonJS usage
-For supported Node.js versions, the package can also be loaded through CommonJS:
 ```javascript
 const {
   makeWASocket,
@@ -112,88 +123,52 @@ If your runtime or bundler does not support this interop path, use the ESM impor
 ## Core capabilities
-### Connections and authentication
-The socket layer manages WebSocket connection events, reconnect handling, browser identity configuration, pairing-code flows, and connection state transitions. Authentication helpers include multi-file credentials for standard deployments, single-file state for compact setups, SQLite-backed persistence when the optional driver is installed, and cache-manager integrations for applications that need custom persistence.
-### Messages and conversations
-The message API supports text, mentions, replies, reactions, edits, deletions, forwards, polls, contacts, locations, events, group invitations, quoted messages, disappearing messages, view-once envelopes, and other protocol message types. Message composition is centralized so applications can use the ordinary `sendMessage` flow while opting into advanced structures when required.
-### Media and albums
-Images, video, audio, documents, stickers, thumbnails, and albums are supported. Media can be prepared from URLs, local files, or buffers according to the upload configuration. Video messages can opt into GIF playback, and the image-processing layer can use an available `sharp`, `@napi-rs/image`, or `jimp` implementation. Album child-message association uses the WhatsApp-compatible wire value.
-### Interactive content
-The package includes interactive buttons, lists, native flows, hydrated templates, carousel layouts, button grids, and other structured message formats. Interactive identifiers should be stable and unique within the application. Receiving code should handle the possibility that different WhatsApp clients deliver a selected value through different response envelopes.
-### Rich content and previews
-Rich-response utilities cover code blocks, tables, inline entities, LaTeX-oriented content, link previews, and structured response arrays. Rich previews can fetch a title, description, and image for a URL when the optional dependency and network access are available. Applications should retain a plain-text fallback for clients that do not render rich content.
-### Rich menus
-The experimental `richMenu` helper builds a structured rich-response envelope with an optional header image, row or carousel cards, stable button identifiers, toast metadata, disclaimers, and a footer action. The package also exposes lower-level preparation utilities for applications that need more control. Rich menus are client-dependent and should be tested against the WhatsApp versions used by the application.
-### Groups and communities
-Group operations include group creation, participant management, settings, metadata, invites, labels, and community relationships. Community helpers support linked groups and subgroup operations where the connected account and current protocol permit them.
-### Newsletters and channel operations
-Newsletter utilities cover channel metadata, following and unfollowing, posts, reactions, media, and polls. Following is consumer-controlled: the library does not silently follow a trusted channel, inject a fallback channel identifier, or add an automatic channel pill to generated media. Applications should request newsletter actions explicitly and validate identifiers before sending requests.
-### Account, business, and privacy tools
-The package includes profile and business helpers, product and catalog operations, privacy controls, username utilities, account-layer and interoperation helpers, status publishing, favorites management, and selected account-management operations. Availability depends on the connected account, WhatsApp rollout, and the permissions associated with that account.
-### Storage and protocol utilities
-The distribution includes in-memory and ordered-dictionary stores, cache-manager support, authentication persistence, LID and phone-number resolution, event utilities, message normalization, media retry handling, protocol helpers, and TypeScript declarations in `lib/index.d.ts`.
+| Area | What it covers |
+| --- | --- |
+| Connections & authentication | WebSocket connection events, reconnect handling, browser identity configuration, pairing-code flows, connection state transitions |
+| Auth persistence | Multi-file credentials, single-file state, SQLite-backed persistence (optional driver), cache-manager integrations |
+| Messages & conversations | Text, mentions, replies, reactions, edits, deletions, forwards, polls, contacts, locations, events, group invitations, quoted messages, disappearing messages, view-once envelopes |
+| Media & albums | Images, video, audio, documents, stickers, thumbnails, albums; sourced from URLs, local files, or buffers; optional `sharp` / `@napi-rs/image` / `jimp` image processing; GIF-style video playback |
+| Interactive content | Buttons, lists, native flows, hydrated templates, carousel layouts, button grids |
+| Rich content & previews | Code blocks, tables, inline entities, LaTeX-oriented content, link previews, structured response arrays |
+| Rich menus (experimental) | Header image, row/carousel cards, stable button IDs, toast metadata, disclaimers, footer action |
+| Groups & communities | Group creation, participant management, settings, metadata, invites, labels, community/subgroup relationships |
+| Newsletters & channels | Channel metadata, follow/unfollow, posts, reactions, media, polls |
+| Account, business & privacy | Profile/business helpers, product & catalog operations, privacy controls, username utilities, status publishing, favorites management |
+| Storage & protocol utilities | In-memory and ordered-dictionary stores, cache-manager support, LID/phone-number resolution, event utilities, message normalization, media retry handling, TypeScript declarations |
 ## Everyday message usage
-Send a text message with the standard socket method:
+| Message type | Key options | Example |
+| --- | --- | --- |
+| Text | `text` | `sock.sendMessage(jid, { text: '...' })` |
+| Media with caption | `image` / `video` / `audio` / `document`, `caption` | `sock.sendMessage(jid, { image: { url } , caption: '...' })` |
+| GIF-style video | `video`, `gifPlayback: true` | `sock.sendMessage(jid, { video: { url }, gifPlayback: true })` |
+| View-once media | `viewOnce: true` (also `viewOnceV2`, `viewOnceV2Extension`, `spoiler`) | `sock.sendMessage(jid, { image: { url }, viewOnce: true })` |
+| Spoiler / view-once (new) | `mediaSpoilerMode: 'viewOnce' \| 'native'` | see below |
 ```javascript
 await sock.sendMessage(jid, {
   text: 'A message from Codex'
 })
-```
-Send media with a caption:
-```javascript
 await sock.sendMessage(jid, {
   image: { url: './media/photo.jpg' },
   caption: 'A photo message'
 })
-```
-Send a video with GIF-style playback enabled:
-```javascript
 await sock.sendMessage(jid, {
   video: { url: './media/animation.mp4' },
   gifPlayback: true,
   caption: 'Animated media'
 })
-```
-Use the existing explicit view-once options when you want the media to use a view-once envelope:
-```javascript
 await sock.sendMessage(jid, {
   image: { url: './media/private-image.jpg' },
   caption: 'Open once',
   viewOnce: true
 })
-```
-The compatible `mediaSpoilerMode` option provides an additional explicit path. Set it to `viewOnce` for supported image, video, document, or sticker media, or set it to `native` to apply the native spoiler context flag. The option is intentionally opt-in and does not change the default behavior of existing applications.
-```javascript
 await sock.sendMessage(jid, {
   video: { url: './media/clip.mp4' },
   caption: 'View-once video',
@@ -206,11 +181,16 @@ await sock.sendMessage(jid, {
 })
 ```
-The existing `viewOnce`, `viewOnceV2`, `viewOnceV2Extension`, and `spoiler` options remain supported. When an explicit view-once option is enabled, it takes precedence over `mediaSpoilerMode`.
+`mediaSpoilerMode` is an additional, opt-in path for supported image, video, document, or sticker media:
-## Rich menu example
+| Value | Effect |
+| --- | --- |
+| `viewOnce` | Wraps supported media in a view-once envelope |
+| `native` | Applies the native spoiler context flag |
+The existing `viewOnce`, `viewOnceV2`, `viewOnceV2Extension`, and `spoiler` options remain supported and take precedence over `mediaSpoilerMode` when explicitly set.
-The experimental rich-menu helper accepts a header, card rows or a carousel, stable button IDs, and a footer action:
+## Rich menu example
 ```javascript
 await sock.richMenu(jid, {
@@ -245,9 +225,21 @@ await sock.richMenu(jid, {
 })
 ```
+| Rich menu field | Purpose |
+| --- | --- |
+| `header` | Optional title and image shown above the menu |
+| `body.row` / `body.carousel` | Layout mode for the cards |
+| `body.cards` | Rows of stable button IDs and labels |
+| `footer` | Text plus an optional action URL |
 ## Status, grids, tables, and flows
-The socket also provides helpers for status posts, status mentions, button grids, interactive tables, and WhatsApp flows:
+| Helper | Purpose |
+| --- | --- |
+| `sendStatus` | Post a status update, optionally with mentions via `statusJidList` |
+| `sendRichButtonGrid` | Send a card grid of stable-ID buttons |
+| `sendInteractiveTable` | Send tabular content with headers, rows, and action buttons |
+| `sendWhatsAppFlow` | Launch a published WhatsApp Flow |
 ```javascript
 await sock.sendStatus({ text: 'New Codex status' }, {
@@ -287,14 +279,17 @@ These helpers are protocol- and client-dependent. Use graceful fallbacks when an
 ## Authentication and deployment guidance
-Authentication data contains sensitive account credentials. Keep the session directory private, exclude it from version control, and use a dedicated service account or restricted filesystem permissions where possible. Do not place access tokens, private keys, phone numbers, or personal account data in the README, package archive, or a public repository.
-For production deployments, pin dependencies with a lockfile, use a supported Node.js runtime, monitor connection events, handle logout separately from recoverable disconnects, and keep reconnect logic from creating uncontrolled parallel sockets.
+| Practice | Detail |
+| --- | --- |
+| Session privacy | Keep the session directory private and excluded from version control |
+| Access control | Use a dedicated service account or restricted filesystem permissions where possible |
+| Secrets handling | Do not place access tokens, private keys, phone numbers, or personal account data in the README, package archive, or a public repository |
+| Dependency pinning | Pin dependencies with a lockfile for production deployments |
+| Runtime | Use a supported Node.js runtime |
+| Connection handling | Monitor connection events; handle logout separately from recoverable disconnects; avoid uncontrolled parallel sockets on reconnect |
 ## Development workflow
-Run the package tests with:
 ```bash
 npm test
 ```
@@ -303,33 +298,155 @@ Before submitting changes, validate ESM syntax, CommonJS compatibility where app
 ## Recent compatibility updates
-The current source includes the verified album compatibility correction: album child messages use association type `1`, the compatible child-association wire value, rather than treating the `MEDIA_ALBUM` message category as the association value.
-The source also preserves the package’s explicit view-once implementations and exposes the opt-in `mediaSpoilerMode` path for applications that want either a view-once envelope or a native spoiler context flag without changing existing defaults.
+| Update | Detail |
+| --- | --- |
+| Album association fix | Album child messages use association type `1`, the compatible child-association wire value, rather than treating the `MEDIA_ALBUM` message category as the association value |
+| View-once preserved | Explicit view-once implementations remain unchanged |
+| `mediaSpoilerMode` | New opt-in path for a view-once envelope or native spoiler flag, without altering existing defaults |
 ## About Codex
 This package is built and maintained by **Codex**, also known as **Dev Codex**. Codex is a developer from Nigeria who focuses on practical, accessible, and reliable software projects across the JavaScript and TypeScript ecosystem.
-Codex works with JavaScript, HTML, TypeScript, Node.js, GitHub, Baileys, APIs, key-value stores, and related developer tools. Projects include application development, websites, WhatsApp bots, Telegram bots, API endpoints, and games.
-The developer’s work is driven by a commitment to learning, experimentation, clear documentation, and useful software that developers can understand and extend. This package reflects that commitment through its readable source, public declarations, practical examples, and emphasis on responsible automation.
+| | |
+| --- | --- |
+| Tech stack | JavaScript, HTML, TypeScript, Node.js, GitHub, Baileys, APIs, key-value stores |
+| Project types | Application development, websites, WhatsApp bots, Telegram bots, API endpoints, games |
+| Telegram | [@codexverified](https://t.me/codexverified) |
+| Email | codexauthorized@gmail.com |
-For updates and direct contact, connect with Codex on Telegram at [@codexverified](https://t.me/codexverified).
-Email: codexauthorized@gmail.com
+The developer's work is driven by a commitment to learning, experimentation, clear documentation, and useful software that developers can understand and extend. This package reflects that commitment through its readable source, public declarations, practical examples, and emphasis on responsible automation.
 ## Package layout
-The `lib/` directory contains the JavaScript implementation, supporting utilities, and public TypeScript declarations. `WAProto/` contains generated WhatsApp protocol definitions. `engine-requirements.js` performs installation-time runtime checks. `package.json` contains package metadata, scripts, dependencies, and exports. This `README.md` is the user-facing installation and usage guide.
+| Path | Contents |
+| --- | --- |
+| `lib/` | JavaScript implementation, supporting utilities, public TypeScript declarations |
+| `WAProto/` | Generated WhatsApp protocol definitions |
+| `engine-requirements.js` | Installation-time runtime checks |
+| `package.json` | Package metadata, scripts, dependencies, exports |
+| `README.md` | User-facing installation and usage guide |
 ## Security and responsible use
-This library interacts with WhatsApp accounts and user communications. Use it only with accounts and data you are authorized to control. Respect WhatsApp’s terms, applicable law, and the privacy expectations of message participants. Avoid unsolicited messaging, protect authentication state, limit access to stored media, and provide clear notice when an application performs automated actions.
+This library interacts with WhatsApp accounts and user communications.
-Never commit session files, access tokens, private keys, phone numbers, or other personal information to a public repository. Review installation scripts and optional dependencies before deploying to production, and use pinned dependency versions for repeatable builds.
+| Guideline | Detail |
+| --- | --- |
+| Authorization | Use only with accounts and data you are authorized to control |
+| Compliance | Respect WhatsApp's terms, applicable law, and message participants' privacy expectations |
+| Messaging conduct | Avoid unsolicited messaging |
+| Credential safety | Protect authentication state and never commit session files, tokens, private keys, or personal data to a public repository |
+| Media access | Limit access to stored media |
+| Transparency | Provide clear notice when an application performs automated actions |
+| Dependency review | Review installation scripts and optional dependencies before deploying to production; use pinned versions for repeatable builds |
 ## License and maintenance
 This distribution is provided under the license declared in `package.json` and the accompanying license file. Review those terms before redistributing or combining this package with third-party code.
 **@codexverified/baileys is built and maintained by Codex under the CodexVerified organization.** Contributions, bug reports, and carefully documented improvements are welcome through the project repository.
+## Compatibility additions
+The current source includes several independently implemented compatibility helpers identified during comparison with the published upstream package. These additions preserve the Codex package identity and do not copy package-specific attribution enforcement or remote licensing checks.
+### Copy-to-clipboard rich response
+`sendCopyButton` creates a forwarded GenAI-style rich response with a copy-to-clipboard addon action.
+| Option | Purpose |
+| --- | --- |
+| `text` | The content that gets copied |
+| `label` | Optional visible button text |
+| `alignment` | `END`, `START`, or `CENTER` |
+```javascript
+await sock.sendCopyButton(jid, {
+  text: 'npm install @codexverified/baileys',
+  label: 'Copy install command',
+  alignment: 'END'
+})
+```
+As with other private or experimental WhatsApp rich-response layouts, clients may fall back to plain rendering or ignore the addon action.
+### Slot-machine HTML generator
+`generateSlotMachineHtml` produces a self-contained five-reel Fruit Bonanza game with adjustable starting credits. It is a standalone HTML payload and performs no network requests.
+| Option | Purpose |
+| --- | --- |
+| `title` | Display title for the generated page |
+| `startingCredits` | Initial credit balance |
+```javascript
+import { generateSlotMachineHtml } from '@codexverified/baileys'
+const html = generateSlotMachineHtml({
+  title: 'Codex Fruit Bonanza',
+  startingCredits: 500
+})
+```
+The generator does not by itself send HTML through WhatsApp. Applications should only use an HTML-capable message primitive when that primitive is available and authorized for their deployment.
+### Optional ban-status checker
+`checkStatusWA` is an explicit, caller-invoked diagnostic helper. It is never called during installation, socket creation, reconnection, or message sending. The endpoint is configurable, credentials are not embedded, and callers should review the endpoint's terms and privacy implications before sending a phone number.
+```javascript
+import { checkStatusWA } from '@codexverified/baileys'
+const result = await checkStatusWA('+447700900123', {
+  diagnostic: true
+})
+console.log(result.status) // active, banned, blocked, not_registered, rate_limited, or unknown
+```
+| Status value | Meaning |
+| --- | --- |
+| `active` | Number appears active on WhatsApp |
+| `banned` | Number appears banned |
+| `blocked` | Number appears blocked |
+| `not_registered` | Number is not registered on WhatsApp |
+| `rate_limited` | Check was rate limited |
+| `unknown` | Status could not be determined |
+This helper is not an anti-ban guarantee, does not bypass enforcement, and should not be used for bulk enumeration or unsolicited checking.
+## Comparison references
+The feature comparison was based on the published package metadata and documentation available from [npm][1] and the independent package analysis page at [Socket][2]. The Codex implementation adds compatible behavior through readable, package-owned code rather than copying upstream-specific integrity, attribution, or remote-verification mechanisms.
+[1]: https://www.npmjs.com/
+[2]: https://socket.dev/
+## Additional functional compatibility helpers
+The source also exposes portable helpers for native-flow responses, view-once inspection, rich content preparation, HTML payload construction, and website previews. These are functional compatibility APIs only; package-specific identity checks, attribution enforcement, remote license gates, trusted-channel auto-follow behavior, and other ownership structures are not included.
+| Helper | Purpose |
+| --- | --- |
+| `parseNativeFlowResponse` | Normalize quick-reply, single-select, and Flow response envelopes |
+| `parseWhatsAppFlowResponse` | Return only responses identified as WhatsApp Flow responses |
+| `buildWhatsAppFlowButton` / `makeWhatsAppFlowButton` | Build published Flow button parameters for a caller-owned Flow ID and token |
+| `prepareRichTextMessage` | Build a forwarded rich text response |
+| `prepareRichImageMessage` | Build a forwarded rich image response |
+| `prepareRichLinkMessage` | Build a forwarded response with inline link entities |
+| `prepareRichGenerationMessage` | Build a rich response from caller-provided rich content |
+| `prepareHtmlMessage` | Build an HTML primitive payload for clients that support the experimental structure |
+| `prepareSlotMachineMessage` | Wrap the local slot-machine generator as an HTML message payload |
+| `generateLinkPreviewHtml` / `generateWebsitePreviewHtml` | Create escaped link cards or an explicitly requested metadata preview |
+| `parseViewOnceInfo` and related helpers | Inspect, download, reconstruct, and apply explicit view-once policies |
+All networked helpers are opt-in. Website previews fetch only when explicitly called, and Flow helpers require credentials and identifiers owned by the application. Experimental WhatsApp layouts remain client-dependent and should always have a plain-text fallback.
+## AI generation primitive
+`buildImaginePrimitive` creates the Meta-style AI image or animation generation-state payload used by rich responses. It is a pure payload builder — it does not call a generation service itself, generate media, or send anything on its own; callers wire it up to whatever AI generation backend they use, then pass the resulting primitive into a rich-response message.
+| Field | Purpose |
+| --- | --- |
+| `state` | Generation status: `GENERATING`, `COMPLETE`, or `ERROR` |
+| `mediaUrl` | URL of the generated media

package/lib/Socket/index.js CHANGED Viewed

@@ -36,7 +36,7 @@ const makeWASocket = (config) => {
         };
         console.log(
             `\n${yellow}${center('CODEX TECHNOLOGY')}${reset}\n` +
-            `${blue}${center('@codexverified/Baileys')}${reset}\n` +
+            `${blue}${center('@codexverified/baileys')}${reset}\n` +
             `${yellow}${center('premium baileys built by codex')}${reset}\n`
         );
     }

package/lib/Socket/messages-send.js CHANGED Viewed

@@ -16,7 +16,7 @@ import { collectMetaAIBotParticipantJids, isMetaAIBotResponse, META_AI_BOT_JID }
 import { makeUsernameSocket } from './username.js';
 const STATUS_JID = 'status@broadcast';
-const normalizeStatusJidList = (value) => {
+export const normalizeStatusJidList = (value) => {
     if (!Array.isArray(value) || value.length === 0) {
         throw new Boom('statusJidList must contain at least one recipient JID', { statusCode: 400 });
     }
@@ -1223,6 +1223,13 @@ export const makeMessagesSocket = (config) => {
             await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata });
             return fullMsg;
         },
+        sendCopyButton: async (jid, content = {}, options = {}) => {
+            const { prepareCopyToClipboardMessage } = await import('../Utils/rich-message-utils.js');
+            const message = prepareCopyToClipboardMessage(content);
+            const fullMsg = await generateWAMessageFromContent(jid, message, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
+            await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata });
+            return fullMsg;
+        },
         sendInteractiveTable: async (jid, table, options = {}) => {
             const { title = '', headers = [], rows = [], image, buttons = [], footer } = table || {};
             if (!Array.isArray(headers) || !Array.isArray(rows) || !Array.isArray(buttons)) throw new Boom('sendInteractiveTable expects headers, rows, and buttons arrays', { statusCode: 400 });

package/lib/Utils/ban-checker.js ADDED Viewed

@@ -0,0 +1,48 @@
+/**
+ * Optional WhatsApp registration-status checker.
+ *
+ * This module is deliberately opt-in. It does not run during installation,
+ * connection setup, or message sending, and it does not contain credentials.
+ * Callers should review the endpoint and applicable terms before use.
+ */
+const cleanNumber = (value) => String(value ?? '').replace(/[\s().\-/]/g, '').replace(/^00/, '').replace(/^\+/, '');
+export const normalizeBanCheckNumber = (value) => {
+    const number = cleanNumber(typeof value === 'object' ? value.number : value);
+    if (!/^\d{6,15}$/.test(number)) throw new TypeError('number must be an international phone number');
+    return `+${number}`;
+};
+export const checkStatusWA = async (number, options = {}) => {
+    const normalized = normalizeBanCheckNumber(number);
+    const endpoint = options.endpoint || 'https://v.whatsapp.net/v2/exist';
+    const fetchImpl = options.fetch || globalThis.fetch;
+    if (typeof fetchImpl !== 'function') throw new TypeError('a fetch implementation is required');
+    const url = new URL(endpoint);
+    url.searchParams.set('in', normalized.slice(1));
+    const response = await fetchImpl(url, {
+        method: 'GET',
+        headers: { ...(options.headers || {}) },
+        signal: options.signal
+    });
+    let body = null;
+    try { body = await response.json(); } catch { body = null; }
+    const reason = String(body?.reason || body?.error || body?.status || '').toLowerCase();
+    let status = 'unknown';
+    if (response.status === 429 || /rate.?limit|too many/.test(reason)) status = 'rate_limited';
+    else if (/blocked|official|banned|ban|temporar|perman/.test(reason)) status = /banned|ban|temporar|perman/.test(reason) ? 'banned' : 'blocked';
+    else if (/not.?registered|does.?not.?exist/.test(reason)) status = 'not_registered';
+    else if (response.ok) status = 'active';
+    return {
+        number: normalized,
+        status,
+        isBanned: status === 'banned',
+        isNeedOfficialWa: status === 'blocked',
+        diagnostics: options.diagnostic === true ? {
+            httpStatus: response.status,
+            ok: response.ok,
+            bodyKeys: body && typeof body === 'object' ? Object.keys(body).sort() : []
+        } : undefined
+    };
+};

package/lib/Utils/games/slot-machine.js ADDED Viewed

@@ -0,0 +1,258 @@
+/**
+ * Slot Machine Game — Fruit Bonanza
+ *
+ * A complete canvas-based slot machine game that renders directly
+ * inside WhatsApp chat bubbles using FOAHtmlPrimitiveDemoDONOTUSE.
+ *
+ * Features:
+ * - 5 reels with Cherry, Lemon, Bell, Diamond, 7, BAR symbols
+ * - Betting system (10/20/50 credits)
+ * - Win detection with 5 paylines
+ * - Canvas-rendered symbols with animations
+ * - Jungle/green theme
+ * - Lever animation
+ * - Jackpot display & game over screen
+ *
+ * Usage:
+ *   const { generateSlotMachineHtml } = require('./slot-machine');
+ *   const html = generateSlotMachineHtml();
+ *   await sock.sendHtmlMessage(jid, { html });
+ */
+const SLOT_MACHINE_HTML = `<html><head><style>
+*{box-sizing:border-box}html,body{margin:0;width:100%;overflow:hidden;background:transparent;font-family:Arial,sans-serif;overscroll-behavior:none}body{padding:9px;background:radial-gradient(circle at 50% 12%,#5b2d18,#160908 55%,#030202)}.machine{position:relative;overflow:hidden;padding:13px 34px 18px 13px;border:4px solid #2b0c05;border-radius:30px;background:linear-gradient(105deg,#1e0704,#8c3515 8%,#3b1008 20%,#611e0c 52%,#2b0906 82%,#9c401b 94%,#2a0b06);box-shadow:inset 0 0 0 3px #e6a139,inset 0 0 0 7px #5d210b,inset 0 20px 35px #ffb52a22,0 8px 0 #210705,0 14px 24px #000c;touch-action:none}.machine:before{content:"";position:absolute;inset:8px;border:2px solid #ffba3d;border-radius:22px;pointer-events:none;box-shadow:inset 0 0 11px #ff7b00}.lights{height:9px;margin:0 14px 8px;border:2px solid #6f2608;border-radius:8px;background:repeating-radial-gradient(circle at 6px 50%,#fffbd3 0 2px,#ffbd00 3px 5px,#641800 6px 12px);box-shadow:0 0 12px #ff8a00;animation:lights .55s steps(2) infinite}.title{padding:11px 4px 8px;border:3px solid #ffc54c;border-radius:50% 50% 11px 11px/30% 30% 10px 10px;color:#fff2a1;background:radial-gradient(ellipse at 50% 0,#12b2bc,#075165 58%,#06182a);box-shadow:inset 0 0 0 4px #74300d,inset 0 -11px 18px #001726,0 4px 0 #3b1207;text-align:center;font:25px Impact,Arial Black,sans-serif;letter-spacing:1px;text-shadow:0 3px #8f1c0c,2px 0 #8f1c0c,-2px 0 #8f1c0c}.jackpot{width:75%;margin:5px auto 8px;padding:4px;border:2px solid #ffcf5b;border-radius:10px;color:#ffe7a1;background:linear-gradient(#741523,#29060e);box-shadow:inset 0 2px 5px #ff667744;text-align:center;font:bold 10px monospace;letter-spacing:1px}.stats{display:flex;margin:0 2px 9px;padding:5px;border:2px solid #b66b20;border-radius:9px;background:linear-gradient(#210c08,#070303);box-shadow:inset 0 0 9px #000,0 3px 0 #4a1909}.stat{flex:1;border-right:1px solid #754016;color:#d6a15b;text-align:center;font:bold 10px monospace}.stat:last-child{border:0}.stat b{display:block;margin-top:2px;color:#fff0bb;font-size:15px;text-shadow:0 0 6px #f80}.frame{position:relative;padding:9px;border:5px solid #9b4e12;border-radius:18px;background:linear-gradient(90deg,#4b1c08,#ffd873 5%,#6a2709 10%,#6a2709 90%,#ffd873 95%,#421506);box-shadow:inset 0 0 0 3px #2b0d05,0 4px 0 #301005,0 8px 15px #000b}.reelbox{position:relative;display:grid;grid-template-columns:repeat(5,1fr);height:192px;overflow:hidden;border:3px solid #1d0804;border-radius:11px;background:#140604;box-shadow:inset 0 13px 20px #000,inset 0 -13px 20px #000}.reel{position:relative;overflow:hidden;border-right:2px solid #6e421e;background:linear-gradient(90deg,#a58149,#fffce4 17%,#fffdf0 50%,#f7e9bd 82%,#8e6a38);box-shadow:inset 7px 0 8px #573b1d66,inset -7px 0 8px #573b1d66}.reel:last-child{border:0}.reel:after{content:"";position:absolute;z-index:2;inset:0;pointer-events:none;background:linear-gradient(#3b1d0fbb 0,transparent 18%,transparent 80%,#281208cc 100%);box-shadow:inset 0 9px 11px #0005,inset 0 -9px 11px #0005}.strip{position:absolute;left:0;right:0;top:0;transform:translate3d(0,0,0);will-change:transform,filter}.strip.moving{filter:blur(1.4px) saturate(1.2)}.sym{height:64px;display:grid;place-items:center;border-bottom:1px solid #9f7e4f66;color:#d30f1c;font-family:Apple Color Emoji,Segoe UI Emoji,Arial Black,sans-serif;font-size:clamp(26px,8vw,40px);line-height:1;text-shadow:0 3px 0 #721018,0 0 4px #fff;transform:translateZ(0)}.sym.s4{font:900 42px Impact,Arial Black,sans-serif;color:#ef1726;-webkit-text-stroke:2px #850815;text-shadow:0 3px #5d0509,0 0 5px #fff}.sym.s5{font:900 16px Arial Black,sans-serif;color:#fff4c4;background:radial-gradient(ellipse at center,#e22d35 0,#6f0910 52%,transparent 54%);text-shadow:0 2px #401010}.sym.win{animation:win .5s ease-in-out infinite;background:radial-gradient(circle,#fff8a9,#ffae00 55%,transparent 72%)}.shine{position:absolute;z-index:3;inset:4px 8% 55%;border-radius:50%;background:linear-gradient(#fff7,transparent);pointer-events:none}.payline{position:absolute;z-index:4;left:9px;right:9px;height:3px;opacity:0;background:#fff5a1;box-shadow:0 0 7px #fff,0 0 14px #ff3d00;pointer-events:none}.payline.on{animation:line 1s ease infinite}.p0{top:20%}.p1{top:50%}.p2{top:80%}.message{height:34px;margin:9px 2px 7px;display:grid;place-items:center;border:2px solid #a55c19;border-radius:8px;color:#ffd46a;background:#150504;box-shadow:inset 0 0 8px #000;text-align:center;font:bold 14px monospace;text-shadow:0 0 7px #f60}.console{display:grid;grid-template-columns:1fr 1.7fr;gap:8px;margin:0 3px;padding:10px 9px 13px;border:3px solid #8e4914;border-radius:9px 9px 17px 17px;background:linear-gradient(#d69a49,#63300f 37%,#2a0b06 39%,#4b1509);box-shadow:inset 0 2px #ffe0a0,0 5px #1c0704,0 9px 12px #0008;transform:perspective(300px) rotateX(4deg)}button{height:53px;border:3px solid #351006;border-radius:13px;color:#fff;font-weight:900;touch-action:none}.bet{background:linear-gradient(#42c4df,#086184 53%,#03334c);box-shadow:inset 0 4px 4px #fff8,0 4px #051e2a}.spin{background:radial-gradient(circle at 50% 32%,#8aff77,#20a72d 47%,#075b17 76%);box-shadow:inset 0 4px 5px #e3ffdc,0 4px #07350e,0 0 14px #3cff4a;font-size:18px;text-shadow:0 2px #06420d}.tray{width:49%;height:19px;margin:14px auto 0;border:4px solid #48200b;border-radius:4px 4px 10px 10px;background:#090303;box-shadow:inset 0 6px 9px #000,0 3px #c47c29}.leverTrack{position:absolute;z-index:5;right:9px;top:211px;width:20px;height:150px;border:2px solid #3d1809;border-radius:13px;background:linear-gradient(90deg,#321006,#df9a39,#52200a);box-shadow:inset 0 0 5px #000}.lever{position:absolute;left:-4px;top:8px;width:28px;height:112px;transform-origin:50% 88%;transition:transform .34s cubic-bezier(.2,.8,.2,1);touch-action:none}.lever:before{content:"";position:absolute;left:11px;top:17px;width:7px;height:86px;border:2px solid #333;border-radius:4px;background:linear-gradient(90deg,#444,#fff 48%,#666 64%,#222)}.lever:after{content:"";position:absolute;left:0;width:29px;height:29px;border:3px solid #650000;border-radius:50%;background:radial-gradient(circle at 35% 25%,#fff,#ff7777 13%,#ed1720 37%,#850007 74%);box-shadow:inset -5px -6px 7px #490000,0 4px 5px #000,0 0 9px #f22}.lever.pull{transform:rotate(36deg)}.over{position:absolute;z-index:10;inset:0;display:grid;place-items:center;text-align:center;color:#ffe5a0;background:#080100ed}.over.off{display:none}.over h2{margin:0 0 8px;color:#ff3449;text-shadow:0 0 12px #f00}.over button{padding:0 22px;background:#ffd15a;color:#271204}@keyframes lights{50%{filter:brightness(1.7)}}@keyframes win{50%{transform:scale(1.09);filter:brightness(1.4)}}@keyframes line{50%{opacity:1}}
+</style><style>.reelbox{display:block;height:205px;padding:0;background:#160704}
+#reelCanvas{display:block;width:100%;height:100%;border-radius:8px;touch-action:none}
+</style><style>body{padding:15px 13px 29px;perspective:950px}
+.machine{transform-origin:50% 88%;transform:perspective(850px) rotateX(1.2deg) translateZ(0);box-shadow:inset 0 0 0 3px #f0b64b,inset 0 0 0 8px #501708,inset 14px 0 24px #ffb3421f,inset -15px 0 25px #16030199,0 9px 0 #180503,0 17px 0 #421508,0 27px 35px #000e}
+.machine:after{content:"";position:absolute;z-index:-2;left:7%;right:7%;bottom:-30px;height:30px;border-radius:50%;background:radial-gradient(ellipse,#000d 0,#0008 42%,transparent 73%);filter:blur(4px)}
+.title{transform:perspective(500px) rotateX(-3deg) translateZ(8px);box-shadow:inset 0 0 0 4px #74300d,inset 0 -13px 20px #001522,0 5px 0 #351006,0 10px 16px #0009}
+.frame{transform:perspective(650px) rotateX(-1.5deg) translateZ(7px);box-shadow:inset 0 0 0 3px #2b0d05,inset 0 12px 13px #fff2b21c,0 6px 0 #291006,0 13px 19px #000c}
+.console{transform:perspective(420px) rotateX(8deg) translateZ(5px);transform-origin:50% 0;box-shadow:inset 0 3px #ffe4ac,0 7px #1b0704,0 15px 20px #000b}
+.machine.charging{animation:crateCharge .56s cubic-bezier(.36,.07,.19,.97) both}
+.machine.charging .lights{animation:warningFlash .12s steps(2) infinite}
+.machine.charging .frame{animation:frameTension .56s ease both}
+.machine.charging .title{animation:signTension .56s ease both}
+@keyframes crateCharge{0%{transform:perspective(850px) rotateX(1.2deg) rotateZ(0) translate(0,0) scale(1)}12%{transform:perspective(850px) rotateX(2deg) rotateZ(-.8deg) translate(-2px,1px) scale(.995)}25%{transform:perspective(850px) rotateX(.2deg) rotateZ(1deg) translate(3px,-1px) scale(1.008)}39%{transform:perspective(850px) rotateX(2.2deg) rotateZ(-1.15deg) translate(-3px,1px) scale(.998)}52%{transform:perspective(850px) rotateX(.3deg) rotateZ(.9deg) translate(3px,-2px) scale(1.012)}66%{transform:perspective(850px) rotateX(2deg) rotateZ(-.55deg) translate(-2px,1px) scale(1.004)}79%{transform:perspective(850px) rotateX(.7deg) rotateZ(.35deg) translate(1px,-1px) scale(1.01)}100%{transform:perspective(850px) rotateX(1.2deg) rotateZ(0) translate(0,0) scale(1)}}
+@keyframes warningFlash{50%{filter:brightness(2.2) saturate(1.8);box-shadow:0 0 21px #ffca28}}
+@keyframes frameTension{45%{transform:perspective(650px) rotateX(-2.5deg) translateZ(13px) scale(1.012)}100%{transform:perspective(650px) rotateX(-1.5deg) translateZ(7px)}}
+@keyframes signTension{45%{transform:perspective(500px) rotateX(-5deg) translateZ(15px)}100%{transform:perspective(500px) rotateX(-3deg) translateZ(8px)}}
+</style><style>.machine.charging{animation:leverDip .28s cubic-bezier(.25,.8,.25,1) both}
+.machine.charging .frame,.machine.charging .title{animation:none}
+.machine.reelKick{animation:reelKick .13s cubic-bezier(.2,.8,.3,1)}
+@keyframes leverDip{0%{transform:perspective(850px) rotateX(1.2deg) translateY(0) scale(1)}42%{transform:perspective(850px) rotateX(2.4deg) translateY(3px) scale(.994)}72%{transform:perspective(850px) rotateX(.5deg) translateY(-2px) scale(1.004)}100%{transform:perspective(850px) rotateX(1.2deg) translateY(0) scale(1)}}
+@keyframes reelKick{0%{transform:perspective(850px) rotateX(1.2deg) translateX(0)}35%{transform:perspective(850px) rotateX(1.7deg) translateX(-1.5px) translateY(1px)}70%{transform:perspective(850px) rotateX(.8deg) translateX(1px) translateY(-1px)}100%{transform:perspective(850px) rotateX(1.2deg) translateX(0)}}
+</style><style>.machine.charging,.machine.reelKick{animation:none!important}
+.machine.charging .frame,.machine.charging .title,.machine.charging .lights{animation:none!important}
+.leverTrack{right:9px;top:211px;width:24px;height:158px;overflow:hidden;border-radius:12px}
+.lever{left:0;top:7px;width:24px;height:100px;transform:none;transform-origin:50% 50%;transition:transform .3s cubic-bezier(.2,.8,.2,1)}
+.lever:before{left:8px;top:18px;width:7px;height:77px}
+.lever:after{left:0;top:0;width:24px;height:24px;border-width:2px}
+.lever.pull{transform:translateY(47px)}
+</style><style>
+/* Fixed-pivot lever: the mount stays still; only the arm swings. */
+.machine{
+    padding-right:70px!important;
+}
+.leverTrack{
+    position:absolute!important;
+    right:8px!important;
+    top:205px!important;
+    width:56px!important;
+    height:150px!important;
+    overflow:hidden!important;
+    border-radius:16px!important;
+    transform:none!important;
+}
+.leverTrack:after{
+    content:"";
+    position:absolute;
+    left:2px;
+    bottom:1px;
+    width:27px;
+    height:27px;
+    z-index:3;
+    border:2px solid #5b2509;
+    border-radius:50%;
+    box-sizing:border-box;
+    background:radial-gradient(circle at 35% 30%,#fff6c8 0 8%,#f7bd3d 9% 25%,#9b3d08 52%,#3a1205 76%);
+    box-shadow:inset 0 0 0 3px #ffda67,0 2px 5px #000b;
+}
+.lever{
+    position:absolute!important;
+    left:2px!important;
+    top:auto!important;
+    bottom:9px!important;
+    width:27px!important;
+    height:105px!important;
+    transform:rotate(0deg)!important;
+    transform-origin:13.5px 95px!important;
+    transition:transform .34s cubic-bezier(.2,.88,.25,1.08)!important;
+    z-index:2!important;
+}
+.lever:before{
+    left:10px!important;
+    top:18px!important;
+    width:7px!important;
+    height:80px!important;
+    border-radius:5px!important;
+    background:linear-gradient(90deg,#321003 0,#f3c56f 20%,#fff5cf 43%,#9b4c18 72%,#260b02 100%)!important;
+    box-shadow:0 2px 4px #000b!important;
+}
+.lever:after{
+    left:1px!important;
+    top:0!important;
+    width:24px!important;
+    height:24px!important;
+    border-width:2px!important;
+}
+.lever.pull{
+    transform:rotate(17deg)!important;
+}
+</style><style>
+/* Front-facing pull: fixed lower pivot with perspective foreshortening. */
+.lever{
+    transform:none!important;
+    transform-origin:50% 100%!important;
+    transition:none!important;
+}
+.lever:before{
+    transform:scaleY(1)!important;
+    transform-origin:50% 100%!important;
+    transition:transform .34s cubic-bezier(.2,.85,.25,1)!important;
+}
+.lever:after{
+    transform:translateY(0) scale(1)!important;
+    transform-origin:50% 50%!important;
+    transition:transform .34s cubic-bezier(.2,.85,.25,1.08)!important;
+}
+.lever.pull{
+    transform:none!important;
+}
+.lever.pull:before{
+    transform:scaleY(.56)!important;
+}
+.lever.pull:after{
+    transform:translateY(36px) scale(1.16)!important;
+}
+</style><style>
+/* Rigid front-pulling lever assembly. */
+.machine{padding-right:62px!important}
+.leverTrack{right:8px!important;top:205px!important;width:47px!important;height:150px!important;overflow:hidden!important}
+.leverTrack:after{left:9px!important;bottom:5px!important;width:27px!important;height:27px!important;z-index:4!important}
+.lever{left:0!important;right:0!important;bottom:12px!important;top:auto!important;width:100%!important;height:112px!important;transform:none!important}
+.lever:before,.lever:after{display:none!important}
+.leverArm{position:absolute;left:20px;bottom:7px;width:7px;height:91px;border:2px solid #292929;border-radius:5px;box-sizing:border-box;background:linear-gradient(90deg,#3c3c3c,#fff 43%,#8a8a8a 68%,#252525);box-shadow:0 2px 4px #000b;transform:scaleY(1);transform-origin:50% 100%;transition:transform .34s cubic-bezier(.2,.82,.25,1)}
+.leverKnob{position:absolute;left:-10px;top:-13px;width:27px;height:27px;border:3px solid #650000;border-radius:50%;box-sizing:border-box;background:radial-gradient(circle at 35% 25%,#fff,#ff7777 13%,#ed1720 37%,#850007 74%);box-shadow:inset -5px -6px 7px #490000,0 4px 5px #000,0 0 9px #f22;transform:scaleY(1) scale(1);transition:transform .34s cubic-bezier(.2,.82,.25,1)}
+.lever.pull .leverArm{transform:scaleY(.52)}
+.lever.pull .leverKnob{transform:scaleY(1.9231) scale(1.12)}
+</style><style>
+.leverTrack{display:none!important}
+html,body{min-height:0!important}
+body{padding:4px!important}
+.machine{padding:8px 10px 10px!important;border-width:3px!important;border-radius:22px!important;box-shadow:inset 0 0 0 2px #e6a139,inset 0 0 0 5px #5d210b,inset 0 14px 25px #ffb52a22,0 5px 0 #210705,0 9px 16px #000c!important}
+.machine:before{inset:6px!important;border-radius:17px!important}
+.lights{height:7px!important;margin:0 12px 5px!important}
+.title{padding:7px 4px 5px!important;font-size:21px!important}
+.jackpot{margin:3px auto 5px!important;padding:3px!important}
+.stats{margin:0 2px 6px!important;padding:4px!important}
+.stat b{font-size:13px!important;margin-top:1px!important}
+.frame{padding:6px!important;border-width:4px!important;border-radius:14px!important}
+.reelbox{height:150px!important;border-radius:9px!important}
+.message{height:29px!important;margin:6px 2px 5px!important;font-size:12px!important}
+.console{gap:7px!important;margin:0 3px!important;padding:7px 8px 9px!important}
+button{height:44px!important}
+.spin{font-size:16px!important}
+.tray{height:14px!important;margin-top:9px!important;border-width:3px!important}
+</style><style>
+body{background:radial-gradient(circle at 50% 8%,#1d6a50,#0f4938 48%,#07291f)!important}
+.machine{border-color:#071f18!important;background:linear-gradient(110deg,#061e17,#1b644b 10%,#0b382a 24%,#15543f 54%,#092f24 82%,#28775a 94%,#071f18)!important;box-shadow:inset 0 0 0 2px #b9954d,inset 0 0 0 5px #163f31,inset 0 14px 24px #73d2a31c,0 5px 0 #041a13,0 9px 16px #000b!important}
+.machine:before{border-color:#b59349!important;box-shadow:inset 0 0 9px #4fa57a66!important}
+.lights{border-color:#123d2f!important;background:repeating-radial-gradient(circle at 6px 50%,#dfffdc 0 2px,#82c878 3px 5px,#164936 6px 12px)!important;box-shadow:0 0 9px #67b881!important}
+.title{border-color:#b99a54!important;color:#e9e3bc!important;background:radial-gradient(ellipse at 50% 0,#2b8a6c,#11513f 58%,#082a24)!important;box-shadow:inset 0 0 0 4px #244f3d,inset 0 -10px 17px #061e19,0 4px 0 #071d16!important;text-shadow:0 2px #193f31,2px 0 #193f31,-2px 0 #193f31!important}
+.jackpot{border-color:#a98c4d!important;color:#ded7ad!important;background:linear-gradient(#245d48,#0b3025)!important;box-shadow:inset 0 2px 5px #8ed3a233!important}
+.stats,.message{border-color:#537d64!important;background:linear-gradient(#102d24,#061812)!important}
+.stat{border-color:#416452!important;color:#91b59f!important}.stat b,.message{color:#e3dfbb!important;text-shadow:0 0 6px #62a77d!important}
+.frame{border-color:#315c47!important;background:linear-gradient(90deg,#09271e,#b49a59 5%,#174936 10%,#174936 90%,#b49a59 95%,#09271e)!important;box-shadow:inset 0 0 0 3px #071b15,0 4px 0 #09271e,0 8px 15px #000a!important}
+.reelbox{border-color:#071c15!important;background:#071a14!important;box-shadow:inset 0 9px 15px #0009,inset 0 -9px 15px #0009!important}
+.shine{display:none!important}
+.console{border-color:#416a53!important;background:linear-gradient(#9c8c59,#315d48 37%,#0a2e22 39%,#123e2f)!important;box-shadow:inset 0 2px #d9c992,0 5px #061d16,0 9px 12px #0008!important}
+.bet{background:linear-gradient(#4f9a77,#216348 53%,#103d2d)!important;box-shadow:inset 0 4px 4px #d8ffe055,0 4px #092a20!important}
+.spin{background:radial-gradient(circle at 50% 32%,#a8d96f,#4b8d46 47%,#1e542f 76%)!important;box-shadow:inset 0 4px 5px #e8ffd488,0 4px #12351e,0 0 12px #79b85c88!important}
+.tray{border-color:#244d3a!important;background:#061a13!important;box-shadow:inset 0 6px 9px #000,0 3px #897945!important}
+</style><style>
+.payline{height:3px!important;background:linear-gradient(90deg,transparent,#dfff8a 18%,#fff5b0 50%,#7fe091 82%,transparent)!important;box-shadow:0 0 7px #efffa8,0 0 15px #65c984!important;transform:scaleX(.15);transform-origin:50% 50%}
+.payline.on{opacity:1!important;animation:jungleLine 1.15s cubic-bezier(.2,.8,.2,1) infinite!important}
+.machine.winner .message{animation:jungleDisplay .7s ease-in-out 2!important}
+.machine.winner .lights{animation:jungleLights .22s steps(2) 6!important}
+.machine.winner .title{animation:jungleTitle .7s ease-in-out 2!important}
+@keyframes jungleLine{0%{transform:scaleX(.08);filter:brightness(1)}45%{transform:scaleX(1);filter:brightness(1.8)}75%,100%{transform:scaleX(1);opacity:0}}
+@keyframes jungleDisplay{50%{color:#fff8bd;box-shadow:inset 0 0 14px #7ddc8a,0 0 13px #74ce82;filter:brightness(1.35)}}
+@keyframes jungleLights{50%{filter:brightness(2.2) saturate(1.4)}}
+@keyframes jungleTitle{50%{filter:brightness(1.35);text-shadow:0 0 12px #cfff91,0 2px #193f31}}
+</style><style>
+.machine{
+    box-shadow:inset 0 0 0 2px #b9954d,inset 0 0 0 5px #163f31,inset 0 14px 24px #73d2a31c!important;
+}
+</style><style>
+html,body{width:100%!important}
+body{padding:0!important}
+.machine{width:100%!important;margin:0!important}
+</style></head><body><div class="machine" id="machine"><div class="lights"></div><div class="title">FRUIT BONANZA</div><div class="jackpot">JACKPOT · 10,000 CREDITS</div><div class="stats"><div class="stat">CREDITS<b id="credits">500</b></div><div class="stat">BET<b id="betValue">10</b></div><div class="stat">BEST WIN<b id="best">0</b></div></div><div class="frame"><div id="reelbox" class="reelbox"><canvas id="reelCanvas"></canvas></div><div class="shine"></div><i class="payline p0"></i><i class="payline p1"></i><i class="payline p2"></i></div><div id="message" class="message">SPIN TO PLAY</div><div class="console"><button id="bet" class="bet">BET +</button><button id="spin" class="spin">SPIN</button></div><div class="tray"></div><div class="leverTrack"><div id="lever" class="lever"><i class="leverArm"><i class="leverKnob"></i></i></div></div><div id="over" class="over off"><div><h2>GAME OVER</h2><p>No more credits.<br>Best Win: <b id="finalBest">0</b></p><button id="restart">NEW GAME</button></div></div></div><script>(function(){var labels=['\\u{1F352}','\\u{1F34B}','\\u{1F514}','\\u{1F48E}','7','BAR'],weights=[30,25,18,12,8,7],pays=[2,3,5,8,12,20],credits=500,bet=10,best=0,busy=false,winCells=[],reels=[],sparks=[],winUntil=0,canvas=document.getElementById('reelCanvas'),ctx=canvas.getContext('2d'),C=document.getElementById('credits'),BV=document.getElementById('betValue'),BS=document.getElementById('best'),MSG=document.getElementById('message'),SP=document.getElementById('spin'),BT=document.getElementById('bet'),LV=document.getElementById('lever'),OV=document.getElementById('over'),FB=document.getElementById('finalBest'),MCH=document.getElementById('machine'),PL=document.querySelectorAll('.payline'),D=Math.min(devicePixelRatio||1,2),W,H,last=0,startTime=0;function pick(){var n=Math.random()*100,s=0;for(var i=0;i<weights.length;i++){s+=weights[i];if(n<s)return i}return 0}function buildStrip(){var a=[];for(var i=0;i<80;i++)a.push(pick());return a}function resize(){var r=canvas.getBoundingClientRect();W=r.width;H=r.height;canvas.width=Math.round(W*D);canvas.height=Math.round(H*D);ctx.setTransform(D,0,0,D,0,0);draw()}function ui(){C.textContent=credits;BV.textContent=bet;BS.textContent=best}function clearWins(){winCells=[];sparks=[];winUntil=0;MCH.classList.remove('winner');for(var i=0;i<PL.length;i++)PL[i].classList.remove('on')}for(var c=0;c<5;c++)reels.push({strip:buildStrip(),pos:Math.floor(Math.random()*60),speed:0,stop:0,stopped:true,decelStart:null,from:0,target:0});function mod(n,m){return((n%m)+m)%m}function symbol(col,row,index,x,y,w,h,curve){var value=reels[col].strip[mod(index,reels[col].strip.length)],won=winCells.some(function(v){return v[0]===col&&v[1]===row}),pulse=won?1+.09*Math.sin(performance.now()/85):1;if(won){var glow=ctx.createRadialGradient(x+w/2,y+h/2,2,x+w/2,y+h/2,w*.72);glow.addColorStop(0,'rgba(255,247,159,.92)');glow.addColorStop(.48,'rgba(119,205,94,.62)');glow.addColorStop(1,'rgba(44,126,75,0)');ctx.fillStyle=glow;ctx.fillRect(x,y,w,h)}ctx.save();ctx.translate(x+w/2,y+h/2);ctx.scale(pulse,curve*pulse);ctx.textAlign='center';ctx.textBaseline='middle';ctx.shadowColor=won?'#d9ff75':'rgba(18,55,38,.28)';ctx.shadowBlur=won?16:3;if(value===4){ctx.font='900 '+Math.floor(h*.72)+'px Impact,Arial Black';ctx.lineWidth=4;ctx.strokeStyle='#790914';ctx.strokeText('7',0,2);ctx.fillStyle='#f31c2b';ctx.fillText('7',0,2)}else if(value===5){ctx.font='900 '+Math.floor(h*.29)+'px Arial Black';ctx.fillStyle='#861019';ctx.beginPath();ctx.ellipse(0,0,w*.38,h*.25,0,0,Math.PI*2);ctx.fill();ctx.fillStyle='#fff0b4';ctx.fillText('BAR',0,1)}else{ctx.font=Math.floor(h*.56)+'px Apple Color Emoji,Segoe UI Emoji,sans-serif';ctx.fillText(labels[value],0,1)}ctx.restore()}function draw(){if(!W||!H)return;ctx.clearRect(0,0,W,H);var rw=W/5,rh=H/3;for(var c=0;c<5;c++){var x=c*rw,reel=reels[c],base=Math.floor(reel.pos),frac=reel.pos-base;var bg=ctx.createLinearGradient(x,0,x+rw,0);bg.addColorStop(0,'#8f6a39');bg.addColorStop(.16,'#fff8d8');bg.addColorStop(.5,'#fffdf0');bg.addColorStop(.84,'#f0dfad');bg.addColorStop(1,'#79552c');ctx.fillStyle=bg;ctx.fillRect(x,0,rw,H);ctx.save();ctx.beginPath();ctx.rect(x,0,rw,H);ctx.clip();ctx.filter=reel.speed>5?'blur(1.3px)':'none';for(var k=-1;k<5;k++){var y=(k-frac)*rh,row=k;var center=(y+rh/2)/H,curve=.78+.22*Math.cos((center-.5)*Math.PI);symbol(c,row,base+k,x,y,rw,rh,curve);ctx.strokeStyle='rgba(92,57,20,.25)';ctx.beginPath();ctx.moveTo(x,y+rh);ctx.lineTo(x+rw,y+rh);ctx.stroke()}ctx.restore();ctx.filter='none';if(c){ctx.fillStyle='#573512';ctx.fillRect(x-1,0,2,H)}}var shade=ctx.createLinearGradient(0,0,0,H);shade.addColorStop(0,'rgba(23,7,2,.72)');shade.addColorStop(.13,'rgba(0,0,0,0)');shade.addColorStop(.48,'rgba(255,255,255,0)');shade.addColorStop(.86,'rgba(0,0,0,0)');shade.addColorStop(1,'rgba(20,5,1,.78)');ctx.fillStyle=shade;ctx.fillRect(0,0,W,H);ctx.strokeStyle='rgba(20,61,43,.45)';ctx.strokeRect(.5,.5,W-1,H-1);drawSparks()}function drawSparks(){var now=performance.now();for(var i=0;i<sparks.length;i++){var s=sparks[i],t=(now-s.born)/1000;if(t<0)continue;var a=Math.max(0,1-t/1.25);if(!a)continue;ctx.save();ctx.globalAlpha=a;ctx.translate(s.x+s.vx*t,s.y+s.vy*t+85*t*t);ctx.rotate(t*s.spin);ctx.fillStyle=s.color;ctx.shadowColor=s.color;ctx.shadowBlur=5;ctx.fillRect(-s.size/2,-s.size/2,s.size,s.size*1.8);ctx.restore()}}function celebrate(now){draw();if(now<winUntil)requestAnimationFrame(celebrate);else{sparks=[];MCH.classList.remove('winner');draw()}}function startWin(){var colors=['#e7d277','#9ce277','#4ebc78','#fff4b0'];sparks=[];for(var i=0;i<34;i++)sparks.push({x:W*(.1+Math.random()*.8),y:H*(.28+Math.random()*.44),vx:(Math.random()-.5)*70,vy:-45-Math.random()*75,born:performance.now()+Math.random()*180,size:2+Math.random()*3,spin:(Math.random()-.5)*12,color:colors[i%colors.length]});winUntil=performance.now()+1450;MCH.classList.add('winner');requestAnimationFrame(celebrate)}function frame(now){if(!busy)return;var dt=Math.min((now-last)/1000,.035);last=now;var stopped=0;for(var c=0;c<5;c++){var r=reels[c],elapsed=now-startTime;if(elapsed<180){r.speed=23*(elapsed/180);r.pos+=r.speed*dt}else if(elapsed<r.stop){r.speed=23;r.pos+=r.speed*dt}else{if(r.decelStart===null){r.decelStart=now;r.from=r.pos;r.target=Math.ceil(r.pos)+7}var p=Math.min(1,(now-r.decelStart)/720),ease=1-Math.pow(1-p,4);r.pos=r.from+(r.target-r.from)*ease;r.speed=(r.target-r.from)*4*Math.pow(1-p,3)/.72;if(p>=1){r.pos=r.target;r.speed=0;r.stopped=true}}if(r.stopped)stopped++}draw();if(stopped===5){busy=false;setTimeout(evaluate,150)}else requestAnimationFrame(frame)}function boardValue(col,row){var r=reels[col];return r.strip[mod(Math.round(r.pos)+row,r.strip.length)]}function evaluate(){LV.classList.remove('pull');var patterns=[[0,0,0,0,0],[1,1,1,1,1],[2,2,2,2,2],[0,1,2,1,0],[2,1,0,1,2]],total=0,wins=[];patterns.forEach(function(p,pi){var a=boardValue(0,p[0]),count=1;for(var x=1;x<5&&boardValue(x,p[x])===a;x++)count++;if(count>=3){total+=Math.floor(bet*pays[a]*(count===3?1:count===4?2:5));wins.push({p:p,n:count,line:pi})}});if(total){credits+=total;best=Math.max(best,total);wins.forEach(function(w){for(var x=0;x<w.n;x++)winCells.push([x,w.p[x]]);if(w.line<3)PL[w.line].classList.add('on')});MSG.textContent=total>=bet*20?'JACKPOT +'+total:'WIN +'+total;startWin()}else MSG.textContent='TRY AGAIN';SP.disabled=false;BT.disabled=false;ui();draw();if(credits<10)setTimeout(gameover,800);else if(bet>credits){bet=10;ui()}}function spin(){if(busy||credits<bet)return;busy=true;clearWins();credits-=bet;ui();SP.disabled=true;BT.disabled=true;MSG.textContent='GOOD LUCK';LV.classList.add('pull');startTime=performance.now();last=startTime;for(var c=0;c<5;c++){reels[c].speed=0;reels[c].stop=1050+c*220;reels[c].stopped=false;reels[c].decelStart=null}requestAnimationFrame(frame)}function gameover(){FB.textContent=best;OV.className='over'}BT.onclick=function(){if(busy)return;bet=bet===10?20:bet===20?50:10;if(bet>credits)bet=10;ui()};SP.onclick=spin;LV.onclick=spin;document.getElementById('restart').onclick=function(){credits=500;bet=10;best=0;busy=false;OV.className='over off';MSG.textContent='SPIN TO PLAY';SP.disabled=false;BT.disabled=false;clearWins();ui();draw()};addEventListener('resize',resize);ui();resize()})();</script></body></html>`;
+/**
+ * Generate the slot machine HTML payload.
+ *
+ * @param {Object} [options]
+ * @param {string} [options.title='FRUIT BONANZA'] - Machine title
+ * @param {number} [options.startingCredits=500] - Starting credits
+ * @returns {string} Complete HTML string for the slot machine
+ */
+export const generateSlotMachineHtml = (options = {}) => {
+    let html = SLOT_MACHINE_HTML;
+    if (options.title && options.title !== 'FRUIT BONANZA') {
+        html = html.replace('FRUIT BONANZA', options.title);
+    }
+    if (options.startingCredits && options.startingCredits !== 500) {
+        html = html.replace(/credits=500/, `credits=${options.startingCredits}`);
+        html = html.replace(/>500</, `>${options.startingCredits}<`);
+    }
+    return html;
+};
+/**
+ * Prepare a slot machine message using the FOAHtmlPrimitiveDemoDONOTUSE primitive.
+ * Returns a wrapped botForwardedMessage ready for relayMessage.
+ *
+ * @param {Object} [options]
+ * @param {string} [options.title] - Machine title
+ * @param {number} [options.startingCredits] - Starting credits
+ * @returns {Object} Wrapped botForwardedMessage
+ */
+export const prepareSlotMachineMessage = (options = {}) => {
+    const html = generateSlotMachineHtml(options);
+    // Lazy import to avoid circular deps
+    const { prepareHtmlMessage } = require('./rich-message-utils.js');
+    return prepareHtmlMessage({ html });
+};
+export default generateSlotMachineHtml;

package/lib/Utils/index.js CHANGED Viewed

@@ -32,3 +32,9 @@ export * from './browser-utils.js';
 export * from './companion-reg-client-utils.js';
 export * from './identity-change-handler.js';
 export * from './stanza-ack.js';
+export * from './games/slot-machine.js';
+export * from './ban-checker.js';
+export * from './native-flow.js';
+export * from './view-once-utils.js';
+export * from './website-preview.js';
+export * from './portable-compat.js';

package/lib/Utils/messages.js CHANGED Viewed

@@ -1385,6 +1385,7 @@ export const generateWAMessageContent = async (message, options) => {
             else if (key) {
                 key.contextInfo = { isSpoiler: true };
             }
+            m = { spoilerMessage: { message: m } };
         }
         delete message.mediaSpoilerMode;
     }

package/lib/Utils/native-flow.js ADDED Viewed

@@ -0,0 +1,48 @@
+const parseJsonObject = (value) => {
+    if (!value) return {};
+    if (typeof value === 'object') return value;
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    } catch { return {}; }
+};
+export const parseNativeFlowResponse = (message) => {
+    const content = message?.message || message;
+    const response = content?.interactiveResponseMessage?.nativeFlowResponseMessage || content?.nativeFlowResponseMessage;
+    if (!response) return null;
+    const params = parseJsonObject(response.paramsJson);
+    const actionPayload = params.flow_action_payload || params.flowActionPayload || {};
+    const data = params.data || params.response || params.form_data || params.formData || actionPayload.data || {};
+    return {
+        name: response.name || '', version: response.version, paramsJson: response.paramsJson || '', params,
+        isFlow: response.name === 'galaxy_message' || response.name === 'flow' || Boolean(params.flow_id || params.flow_token || params.flow_message_version),
+        flowId: params.flow_id || params.flowId, flowToken: params.flow_token || params.flowToken,
+        screen: params.screen || actionPayload.screen, action: params.flow_action || params.flowAction || actionPayload.action,
+        actionPayload, data, buttonId: params.id || params.button_id || params.buttonId,
+        displayText: params.display_text || params.displayText, raw: response
+    };
+};
+export const parseWhatsAppFlowResponse = (message) => {
+    const response = parseNativeFlowResponse(message);
+    return response?.isFlow ? response : null;
+};
+export const buildWhatsAppFlowButton = ({ flowId, flowToken, cta = 'Open form', action = 'navigate', actionPayload, mode = 'published', flowMessageVersion = '3', metadata, name = 'galaxy_message' } = {}) => {
+    if (!flowId) throw new TypeError('flowId is required to launch a WhatsApp Flow');
+    if (!flowToken) throw new TypeError('flowToken is required to launch a WhatsApp Flow');
+    return {
+        name, flow_message_version: String(flowMessageVersion), flow_token: String(flowToken), flow_id: String(flowId),
+        flow_cta: String(cta), flow_action: action,
+        ...(actionPayload ? { flow_action_payload: actionPayload } : {}),
+        ...(metadata ? { flow_metadata: metadata } : {}),
+        ...(mode ? { flow_mode: String(mode) } : {})
+    };
+};
+export const makeWhatsAppFlowButton = (flow) => ({
+    name: flow?.nativeFlowName || 'galaxy_message',
+    buttonParamsJson: JSON.stringify(buildWhatsAppFlowButton(flow))
+});

package/lib/Utils/portable-compat.js ADDED Viewed

@@ -0,0 +1,12 @@
+import { generateRichMenuContent } from './message-composer.js';
+import { prepareRichResponseMessage } from './rich-message-utils.js';
+/** Build a prepared rich-menu payload for direct message generation. */
+export const prepareRichMenuMessage = (content = {}, quoted, options = {}) => generateRichMenuContent(content, quoted, options);
+/** Convert unsupported premium content to a safe plain-text rich response. */
+export const downgradePremiumContent = (content = {}) => {
+    if (typeof content === 'string') return prepareRichResponseMessage({ contentText: content, noDonation: true });
+    const text = content.text || content.contentText || content.caption || '';
+    return prepareRichResponseMessage({ contentText: String(text), noDonation: true });
+};

package/lib/Utils/rich-message-utils.js CHANGED Viewed

@@ -299,7 +299,7 @@ export const prepareRichResponseMessage = (content) => {
         const defaultDonationLink = {
             text: '',
             url: DONATE_URL,
-            title: 'PAIR CRYSNVA AI :',
+            title: 'PAIR CODEX AI :',
             displayName: 'pair bot'
         };
         const resolvedLinks = noDonation ? links : [...(links || []), defaultDonationLink];
@@ -436,4 +436,110 @@ export const wrapToBotForwardedMessage = (richResponseMessage) => ({
         message: { richResponseMessage }
     }
 });
-//# sourceMappingURL=rich-message-utils.js.map
+//# sourceMappingURL=rich-message-utils.js.map
+/**
+ * Build a forwarded rich response with an inline copy-to-clipboard action.
+ * The payload follows WhatsApp's GenAI addon-action layout and is opt-in.
+ * @param {{text?: string, label?: string, alignment?: 'END'|'START'|'CENTER'}} options
+ * @returns {{messageContextInfo: object, botForwardedMessage: object}}
+ */
+export const prepareCopyToClipboardMessage = (options = {}) => {
+    const text = String(options.text ?? '');
+    const label = String(options.label ?? text);
+    const alignment = ['END', 'START', 'CENTER'].includes(options.alignment) ? options.alignment : 'END';
+    const unified = {
+        response_id: randomUUID(),
+        sections: [{
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAIAddonActionLayoutViewModel',
+                addon_action_type: 'COPY_TO_CLIPBOARD',
+                addon_action_alignment: alignment,
+                primitives: [{
+                    __typename: 'GenAIMarkdownTextUXPrimitive',
+                    text: label,
+                    inline_entities: []
+                }]
+            }
+        }]
+    };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 }
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+/** Build a plain rich-text forwarded response. */
+export const prepareRichTextMessage = ({ text = '' } = {}) => prepareRichResponseMessage({ contentText: String(text), noDonation: true });
+/** Build a rich image forwarded response using a GenAI image primitive. */
+export const prepareRichImageMessage = ({ url = '', mimeType = 'image/png' } = {}) => {
+    const media = { __typename: 'GenAIMediaItem', mime_type: mimeType, url: String(url), url_fallback: String(url) };
+    const unified = { response_id: randomUUID(), sections: [{ __typename: 'GenAIUnifiedResponseSection', view_model: { __typename: 'GenAISingleLayoutViewModel', primitive: { __typename: 'GenAIImagePrimitive', preview_image: media, full_image: media } } }] };
+    const rich = proto.AIRichResponseMessage.create({ submessages: [], messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD, unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) }, contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 } });
+    return wrapToBotForwardedMessage(rich);
+};
+/** Build a rich response containing clickable inline links. */
+export const prepareRichLinkMessage = ({ links = [], text = '' } = {}) => {
+    const entities = [];
+    let combined = '';
+    for (const [index, link] of links.entries()) {
+        const key = `INLINE_HYPERLINK_${index}`;
+        const display = String(link?.text || link?.displayName || link?.url || '');
+        combined += `{{${key}}}${display}{{/${key}}}`;
+        entities.push({ key, metadata: { display_name: display, is_trusted: link?.isTrusted !== false, url: String(link?.url || ''), __typename: 'GenAIInlineLinkItem' } });
+    }
+    return prepareRichResponseMessage({ contentText: combined || String(text), links: [], noDonation: true, noHeading: true, richResponse: [{ text: combined || String(text), inlineEntities: entities }] });
+};
+/** Build a rich-generation response from existing rich-response content. */
+export const prepareRichGenerationMessage = (content = {}) => prepareRichResponseMessage({ ...content, noDonation: true });
+/** Build an HTML primitive payload. Use only with an HTML-capable, authorized client. */
+export const prepareHtmlMessage = ({ html = '', trustedSources = [] } = {}) => {
+    const unified = { response_id: randomUUID(), sections: [{ __typename: 'GenAIUnifiedResponseSection', view_model: { primitive: { __typename: 'FOAHtmlPrimitiveDemoDONOTUSE', trusted_sources: trustedSources, payload: String(html).trim() }, __typename: 'GenAISingleLayoutViewModel' } }] };
+    const rich = proto.AIRichResponseMessage.create({ submessages: [], messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD, unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) }, contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 } });
+    return wrapToBotForwardedMessage(rich);
+};
+/** Convenience wrapper for a slot-machine HTML message payload. */
+export const prepareSlotMachineMessage = async (options = {}) => {
+    const { generateSlotMachineHtml } = await import('./games/slot-machine.js');
+    return prepareHtmlMessage({ html: generateSlotMachineHtml(options) });
+};
+/**
+ * Build a Meta-style AI image/video generation primitive.
+ * The payload is useful for displaying generation progress without making any
+ * network request or enabling a hidden background process.
+ */
+export const buildImaginePrimitive = ({
+    mediaType = 'video',
+    url = '',
+    thumbnail,
+    mimeType,
+    fileLength = 0,
+    duration = 0,
+    status = 'GENERATING',
+    estimatedMs,
+    imagineType
+} = {}) => {
+    const normalizedType = String(mediaType).toLowerCase() === 'image' ? 'IMAGE' : 'ANIMATE';
+    return {
+        __typename: 'GenAIImaginePrimitive',
+        media_type: normalizedType,
+        imagine_type: imagineType || normalizedType,
+        status: String(status),
+        ...(url ? { url: String(url), url_fallback: String(url) } : {}),
+        ...(thumbnail ? { thumbnail_url: String(thumbnail) } : {}),
+        ...(mimeType ? { mime_type: String(mimeType) } : {}),
+        ...(fileLength ? { file_length: Number(fileLength) } : {}),
+        ...(duration ? { duration: Number(duration) } : {}),
+        ...(estimatedMs !== undefined ? { estimated_ms: Number(estimatedMs) } : {})
+    };
+};

package/lib/Utils/view-once-utils.js ADDED Viewed

@@ -0,0 +1,56 @@
+import { downloadContentFromMessage } from './messages-media.js';
+export const isViewOnceMessage = (message) => Boolean(message?.message?.viewOnceMessage || message?.message?.viewOnceMessageV2 || message?.message?.viewOnceMessageV2Extension || message?.viewOnceMessage || message?.viewOnceMessageV2 || message?.viewOnceMessageV2Extension);
+export const extractViewOnceContent = (message) => {
+    const content = message?.message || message;
+    return content?.viewOnceMessage?.message || content?.viewOnceMessageV2?.message || content?.viewOnceMessageV2Extension?.message || null;
+};
+export const getViewOnceMediaType = (message) => {
+    const content = extractViewOnceContent(message);
+    if (!content) return null;
+    for (const type of ['image', 'video', 'audio', 'document', 'sticker']) if (content[`${type}Message`]) return type;
+    return null;
+};
+export const getViewOnceMediaContent = (message) => {
+    const content = extractViewOnceContent(message);
+    if (!content) return null;
+    return content.imageMessage || content.videoMessage || content.audioMessage || content.documentMessage || content.stickerMessage || null;
+};
+export const downloadViewOnceMedia = async (message, options = {}) => {
+    const media = getViewOnceMediaContent(message);
+    const type = getViewOnceMediaType(message);
+    if (!media || !type) throw new Error('No supported media content found in view-once message');
+    const stream = await downloadContentFromMessage(media, type, options);
+    const chunks = [];
+    for await (const chunk of stream) chunks.push(chunk);
+    return Buffer.concat(chunks);
+};
+export const createRegularMessageFromViewOnce = (originalMessage, mediaBuffer) => {
+    const media = getViewOnceMediaContent(originalMessage);
+    const type = getViewOnceMediaType(originalMessage);
+    if (!media || !type) return null;
+    return {
+        key: originalMessage.key, messageTimestamp: originalMessage.messageTimestamp,
+        pushName: originalMessage.pushName, participant: originalMessage.participant,
+        decryptedMedia: { type, buffer: mediaBuffer, mimeType: media.mimetype, fileName: media.fileName, caption: media.caption, fileLength: media.fileLength },
+        originalViewOnceMessage: originalMessage.message
+    };
+};
+export const shouldAutoDecryptViewOnce = (message, config = {}) => isViewOnceMessage(message) && config.autoVV !== false && message.key?.fromMe !== true;
+export const shouldDeleteViewOnce = (message, config = {}) => isViewOnceMessage(message) && config.antiVV !== false && message.key?.fromMe !== true;
+export const parseViewOnceInfo = (message) => {
+    const media = getViewOnceMediaContent(message);
+    return {
+        isViewOnce: isViewOnceMessage(message), mediaType: getViewOnceMediaType(message), mimeType: media?.mimetype,
+        fileName: media?.fileName, caption: media?.caption, fileLength: media?.fileLength,
+        hasUrl: Boolean(media?.url), hasDirectPath: Boolean(media?.directPath), hasMediaKey: Boolean(media?.mediaKey)
+    };
+};

package/lib/Utils/website-preview.js ADDED Viewed

@@ -0,0 +1,27 @@
+const escapeHtml = (value) => String(value ?? '').replace(/[&<>"']/g, (character) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[character]));
+const validateUrl = (value) => {
+    const parsed = new URL(value);
+    if (!['http:', 'https:'].includes(parsed.protocol)) throw new TypeError('only HTTP(S) preview URLs are supported');
+    return parsed;
+};
+export const generateLinkPreviewHtml = (url, options = {}) => {
+    const parsed = validateUrl(url);
+    const title = options.title || parsed.hostname;
+    const description = options.description || `Open ${parsed.hostname}`;
+    const image = options.image ? `<img src="${escapeHtml(options.image)}" alt="" loading="lazy">` : '<div class="placeholder">🌐</div>';
+    return `<!doctype html><html><head><meta charset="utf-8"><style>body{margin:0;background:transparent;font:14px system-ui,sans-serif}.card{overflow:hidden;border:1px solid #333;border-radius:12px;background:#1a1a2e;color:#fff}.card img,.placeholder{display:block;width:100%;height:160px;object-fit:cover}.placeholder{display:grid;place-items:center;font-size:48px;background:linear-gradient(135deg,#1a1a2e,#2d2d44)}.body{padding:14px}.title{font-weight:700;margin-bottom:5px}.desc{color:#bbb;line-height:1.4}.url{margin-top:8px;color:#55c878;font-size:11px}</style></head><body><a href="${escapeHtml(parsed.href)}" target="_blank" rel="noopener noreferrer" style="text-decoration:none"><div class="card">${image}<div class="body"><div class="title">${escapeHtml(title)}</div><div class="desc">${escapeHtml(description)}</div><div class="url">${escapeHtml(parsed.hostname)}</div></div></div></a></body></html>`;
+};
+export const generateWebsitePreviewHtml = async (url, options = {}) => {
+    const parsed = validateUrl(url);
+    const response = await (options.fetch || globalThis.fetch)(parsed.href, { signal: options.signal, headers: options.headers || {} });
+    if (!response?.ok) throw new Error(`website preview request failed with status ${response?.status ?? 'unknown'}`);
+    const html = await response.text();
+    const title = html.match(/<title[^>]*>([^<]*)<\/title>/i)?.[1] || parsed.hostname;
+    const description = html.match(/<meta[^>]+name=["']description["'][^>]+content=["']([^"']*)["']/i)?.[1] || `Preview of ${parsed.hostname}`;
+    return generateLinkPreviewHtml(parsed.href, { ...options, title, description });
+};
+export default generateWebsitePreviewHtml;

package/lib/index.d.ts CHANGED Viewed

@@ -259,6 +259,8 @@ export interface WASocket {
     richMenu(jid: string, content?: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a rich button-card grid. */
     sendRichButtonGrid(jid: string, grid: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a GenAI-style inline copy-to-clipboard rich response. */
+    sendCopyButton(jid: string, content: { text: string; label?: string; alignment?: 'END' | 'START' | 'CENTER' }, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a markdown-style interactive table with buttons. */
     sendInteractiveTable(jid: string, table: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a WhatsApp native flow button. */
@@ -293,6 +295,37 @@ export declare function makeCacheManagerAuthState(store: CacheManagerStore, sess
     saveCreds: () => Promise<void>;
 }>;
+/** Generate a self-contained local slot-machine HTML payload. */
+export declare function generateSlotMachineHtml(options?: { title?: string; startingCredits?: number }): string;
+export declare function buildImaginePrimitive(options?: { mediaType?: 'image' | 'video'; url?: string; thumbnail?: string; mimeType?: string; fileLength?: number; duration?: number; status?: string; estimatedMs?: number; imagineType?: string }): Record<string, unknown>;
+export declare function parseNativeFlowResponse(message: unknown): Record<string, unknown> | null;
+export declare function parseWhatsAppFlowResponse(message: unknown): Record<string, unknown> | null;
+export declare function buildWhatsAppFlowButton(flow?: Record<string, unknown>): Record<string, unknown>;
+export declare function makeWhatsAppFlowButton(flow?: Record<string, unknown>): { name: string; buttonParamsJson: string };
+export declare function isViewOnceMessage(message: unknown): boolean;
+export declare function extractViewOnceContent(message: unknown): Record<string, unknown> | null;
+export declare function getViewOnceMediaType(message: unknown): string | null;
+export declare function getViewOnceMediaContent(message: unknown): Record<string, unknown> | null;
+export declare function parseViewOnceInfo(message: unknown): Record<string, unknown>;
+export declare function shouldAutoDecryptViewOnce(message: unknown, config?: Record<string, unknown>): boolean;
+export declare function shouldDeleteViewOnce(message: unknown, config?: Record<string, unknown>): boolean;
+export declare function generateLinkPreviewHtml(url: string, options?: Record<string, unknown>): string;
+export declare function generateWebsitePreviewHtml(url: string, options?: Record<string, unknown>): Promise<string>;
+export declare function prepareRichTextMessage(options?: { text?: string }): Record<string, unknown>;
+export declare function prepareRichImageMessage(options?: { url?: string; mimeType?: string }): Record<string, unknown>;
+export declare function prepareRichLinkMessage(options?: { links?: Array<Record<string, unknown>>; text?: string }): Record<string, unknown>;
+export declare function prepareRichGenerationMessage(content?: Record<string, unknown>): Record<string, unknown>;
+export declare function prepareHtmlMessage(options?: { html?: string }): Record<string, unknown>;
+export declare function prepareSlotMachineMessage(options?: { title?: string; startingCredits?: number }): Promise<Record<string, unknown>>;
+export declare function prepareRichMenuMessage(content?: Record<string, unknown>, quoted?: unknown, options?: Record<string, unknown>): Record<string, unknown>;
+export declare function downgradePremiumContent(content?: unknown): Record<string, unknown>;
+/** Normalize an international phone number for an explicit status check. */
+export declare function normalizeBanCheckNumber(value: string | { number: string }): string;
+/** Perform an explicit, caller-configured WhatsApp registration-status check. */
+export declare function checkStatusWA(number: string | { number: string }, options?: { endpoint?: string; fetch?: typeof fetch; headers?: Record<string, string>; signal?: AbortSignal; diagnostic?: boolean }): Promise<{ number: string; status: string; isBanned: boolean; isNeedOfficialWa: boolean; diagnostics?: { httpStatus: number; ok: boolean; bodyKeys: string[] } }>;
 /** Wrap a socket with anti-ban protection (from the baileys-antiban bundle). */
 export declare function wrapSocket(socket: WASocket, config?: unknown): WASocket;

package/lib/index.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import makeWASocket from './Socket/index.js';
+export { normalizeStatusJidList } from './Socket/messages-send.js';
 export * from '../WAProto/index.js';
 export * from './Utils/index.js';
 export * from './Types/index.js';

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
    "name": "@codexverified/baileys",
-   "version": "2.10.12",
+   "version": "2.12.12",
    "description": "CODEX TECHNOLOGY  a premium Baileys developed and built by Dev Codex, with Meta compositing, bot planning replay, welcome flow, rich messages, interactive messages, albums, and more.",
    "main": "lib/index.js",
    "type": "module",