@prototypevip/baileys 0.1.5 → 0.1.6

package/HELPERS.md

@@ -1,4 +1,4 @@
-# @prototypevip/baileys — Helpers (v0.1.5)
+# @prototypevip/baileys — Helpers (v0.1.6)
 
 طبقة helpers فوق المسارات الأصلية في المكتبة (`sock.sendMessage` → `nativeFlow` / `album` / `code` / `event` / `product`).
 مفيش بروتوكول جديد هنا؛ كل دالة بتفوّض لمسار موجود ومجرَّب.
@@ -105,3 +105,45 @@ const car = sock.carouselBuilder()
 const rich = sock.aiRich()
 // chain methods ثم .send(jid)
 ```
+
+---
+
+## 0.1.6 — View-Once لكل الأنواع
+
+الـ viewOnce بقى بيشتغل على **أي** نوع رسالة (نص، ملف، أزرار، قوائم، كاروسيل، منتج، لوكيشن، جهة اتصال، Rich ...) مش صورة/فيديو/صوت بس.
+
+```js
+// 1) جوه الـ content
+await sock.sendMessage(jid, { text: 'x', nativeFlow: [{ text: 'A', id: '#a' }], viewOnce: true })
+// 2) أو في الـ options (شغال مع كل الـ helpers)
+await sock.sendButtons(jid, { text: 'x', buttons }, { viewOnce: true })
+await sock.sendList(jid, { text: 'x', sections }, { viewOnce: true })
+await sock.sendCarousel(jid, { text: 'x', cards }, { viewOnce: true })
+await sock.sendAlbum(jid, items, { viewOnce: true })      // كل عنصر بيتلف لوحده
+await sock.sendDocument(jid, { url, fileName }, { viewOnce: true })
+// 3) smart: بيوجّه لوحده حسب شكل الـ content
+await sock.sendViewOnce(jid, { text: 'x', cards })        // → sendCarousel
+// 4) Builders
+await new Carousel(sock).setBody('x').addCard(card).setViewOnce().send(jid)
+```
+
+قيم الـ flag: `true` (viewOnceMessage) · `"v2"` (viewOnceMessageV2) · `"force"` (يلف حتى استيكر/استطلاع/ألبوم) · `{ version: 2, force: true }`.
+
+- رسايل التحكم (edit / react / delete / رد التصويت) **مش بتتلف** أبداً.
+- الاستيكر والاستطلاع والألبوم بيتخطوا إلا مع `"force"`.
+- اللف في البروتوكول مضمون؛ سلوك "يختفي بعد أول فتح" للأزرار والكاروسيل بيعتمد على نسخة واتساب عند المستلم.
+- Utils جديدة: `wrapViewOnce` · `unwrapViewOnce` · `isViewOnceContent` · `canWrapViewOnce` · `parseViewOnce`.
+
+### Helpers جديدة
+| Helper | الوظيفة |
+|---|---|
+| `sendDocument(jid, {url\|document, fileName, caption}, opts)` | ملف مع mimetype تلقائي |
+| `sendEdit(jid, key, content)` | تعديل رسالة |
+| `sendDelete(jid, key)` | حذف للكل |
+| `sendWithTyping(jid, content, {typingMs, presence})` | "بيكتب..." ثم إرسال |
+
+### إصلاحات
+- `text` مع `nativeFlow`/`buttons` كان بيتبعت نص عادي من غير أزرار → اتصلح.
+- `contextInfo`/`mentions` مع viewOnce كانوا بيتكتبوا على الغلاف → بقوا على الرسالة الداخلية.
+- `communities.js`: `isPnUser`/`isLidUser` ناقصين import → اتصلحوا.
+- `sendCarousel` بقى بيرجّع الرسالة المرسلة.

package/lib/Socket/communities.js

@@ -10,6 +10,8 @@ import {
   getBinaryNodeChild,
   getBinaryNodeChildren,
   getBinaryNodeChildString,
+  isLidUser,
+  isPnUser,
   jidEncode,
   jidNormalizedUser,
 } from "../WABinary/index.js";

package/lib/Socket/messages-send.js

@@ -43,6 +43,7 @@ import {
 } from "../Utils/index.js";
 import { AssociationType } from "../Types/index.js";
 import { getUrlInfo } from "../Utils/link-preview.js";
+import { wrapViewOnce } from "../Utils/view-once.js";
 import { makeKeyedMutex, makeMutex } from "../Utils/make-mutex.js";
 import {
   getMessageReportingToken,
@@ -1678,10 +1679,12 @@ export const makeMessagesSocket = (config) => {
       } else {
         const interactiveHandler = new InteractiveMessageHandler(Utils_1, waUploadToServer, relayMessage, emitUpsert);
         const messageType = interactiveHandler.detectType(content);
+        // View-Once موحَّد (0.1.6): content.viewOnce أو options.viewOnce
+        const viewOnceFlag = content.viewOnce || options.viewOnce;
         if (messageType) {
             switch (messageType) {
                 case 'PAYMENT': {
-                    const paymentContent = await interactiveHandler.handlePayment(content, options.quoted);
+                    const paymentContent = wrapViewOnce(await interactiveHandler.handlePayment(content, options.quoted), viewOnceFlag);
                     const paymentMsg = generateWAMessageFromContent(jid, paymentContent, { userJid: userJid });
                     await relayMessage(jid, paymentMsg.message, {
                         messageId: paymentMsg.key.id,
@@ -1691,7 +1694,7 @@ export const makeMessagesSocket = (config) => {
                     return paymentMsg;
                 }
                 case 'PRODUCT': {
-                    const productContent = await interactiveHandler.handleProduct(content, jid, options.quoted);
+                    const productContent = wrapViewOnce(await interactiveHandler.handleProduct(content, jid, options.quoted), viewOnceFlag);
                     const productMsg = await generateWAMessageFromContent(jid, productContent, { quoted: options.quoted });
                     await relayMessage(jid, productMsg.message, {
                         messageId: productMsg.key.id,
@@ -1701,7 +1704,7 @@ export const makeMessagesSocket = (config) => {
                     return productMsg;
                 }
                 case 'INTERACTIVE': {
-                    const interactiveContent = await interactiveHandler.handleInteractive(content, jid, options.quoted);
+                    const interactiveContent = wrapViewOnce(await interactiveHandler.handleInteractive(content, jid, options.quoted), viewOnceFlag);
                     const interactiveMsg = await generateWAMessageFromContent(jid, interactiveContent, { quoted: options.quoted });
                     await relayMessage(jid, interactiveMsg.message, {
                         messageId: interactiveMsg.key.id,
@@ -1711,7 +1714,7 @@ export const makeMessagesSocket = (config) => {
                     return interactiveMsg;
                 }
                 case 'ALBUM':
-                    return await interactiveHandler.handleAlbum(content, jid, options.quoted);
+                    return await interactiveHandler.handleAlbum(content, jid, options.quoted, viewOnceFlag);
                 case 'EVENT':
                     return await interactiveHandler.handleEvent(content, jid, options.quoted);
                 case 'POLL_RESULT':
@@ -1846,7 +1849,12 @@ export const makeMessagesSocket = (config) => {
 
         if ("album" in content) {
           const { delayMs = 1500 } = options;
-          for (const albumMedia of content.album) {
+          for (const albumItem of content.album) {
+            // View-Once على الألبوم: كل عنصر (صورة/فيديو) بيتلف لوحده، والـ parent مش بيتلف
+            const albumMedia =
+              content.viewOnce && albumItem.viewOnce === undefined
+                ? { ...albumItem, viewOnce: content.viewOnce }
+                : albumItem;
             const albumMsg = await generateWAMessage(jid, albumMedia, {
               logger: logger,
               userJid: userJid,

package/lib/Utils/index.js

@@ -2,6 +2,7 @@ export * from "./make-mutex.js";
 export * from "./generics.js";
 export * from "./decode-wa-message.js";
 export * from "./messages.js";
+export * from "./view-once.js";
 export * from "./messages-media.js";
 export * from "./validate-connection.js";
 export * from "./crypto.js";

package/lib/Utils/interactive-message-handler.js

@@ -272,7 +272,7 @@ export default class InteractiveMessageHandler {
         };
     }
     
-    async handleAlbum(content, jid, quoted) {
+    async handleAlbum(content, jid, quoted, viewOnce) {
         const array = content.albumMessage;
         const album = await this.utils.generateWAMessageFromContent(jid, {
             messageContextInfo: {
@@ -295,9 +295,11 @@ export default class InteractiveMessageHandler {
         this.emitUpsert(album);
 
         for (let content of array) {
-            const img = await this.utils.generateWAMessage(jid, content, {
-                upload: this.waUploadToServer,
-            });
+            const img = await this.utils.generateWAMessage(
+                jid,
+                viewOnce && content.viewOnce === undefined ? { ...content, viewOnce } : content,
+                { upload: this.waUploadToServer },
+            );
             
             img.message.messageContextInfo = {
                 messageSecret: crypto.randomBytes(32),

package/lib/Utils/message-builder.js

@@ -32,6 +32,7 @@ import crypto from 'crypto';
 import ffmpeg from 'fluent-ffmpeg';
 import { PassThrough, Readable } from 'stream';
 import { generateWAMessageFromContent, prepareWAMessageMedia } from './messages.js';
+import { wrapViewOnce } from './view-once.js';
 
 // sharp اختيارية (peerDependency) — نحمّلها ديناميكيًا وقت الاستخدام فعليًا
 // بدل static import، عشان لو حد ركّب المكتبة من غير ما يثبتها، المكتبة كلها
@@ -504,6 +505,13 @@ class BaseBuilder {
 		this._footer = '';
 		this._contextInfo = {};
 		this._extraPayload = {};
+		this._viewOnce = false;
+	}
+
+	/** View-Once: true | "v2" | "force" | { version, force } — أو false لإلغائه */
+	setViewOnce(flag = true) {
+		this._viewOnce = flag;
+		return this;
 	}
 
 	setTitle(title) {
@@ -793,17 +801,21 @@ export class Button extends BaseBuilder {
 
 	async build(jid, { ...options } = {}) {
 		const message = await this.toCard();
+		const { viewOnce, ...buildOptions } = options;
 
 		return generateWAMessageFromContent(
 			jid,
-			{
-				...this._extraPayload,
-				interactiveMessage: {
-					...message,
-					contextInfo: this._contextInfo,
+			wrapViewOnce(
+				{
+					...this._extraPayload,
+					interactiveMessage: {
+						...message,
+						contextInfo: this._contextInfo,
+					},
 				},
-			},
-			{ ...options }
+				viewOnce ?? this._viewOnce
+			),
+			{ ...buildOptions }
 		);
 	}
 
@@ -881,9 +893,10 @@ export class ButtonV2 extends BaseBuilder {
 
 	async build(jid, { ...options } = {}) {
 		let _thumbnail = this._image ? await Toolkit.resize(Buffer.isBuffer(this._image) ? this._image : await Toolkit.fetchBuffer(this._image, {}, { silent: true }), 300, 300) : null;
+		const { viewOnce, ...buildOptions } = options;
 		const msg = generateWAMessageFromContent(
 			jid,
-			{
+			wrapViewOnce({
 				...this._extraPayload,
 				buttonsMessage: {
 					contentText: this._body,
@@ -900,12 +913,11 @@ export class ButtonV2 extends BaseBuilder {
 									jpegThumbnail: _thumbnail,
 								},
 							}),
-					viewOnce: true,
 					contextInfo: this._contextInfo,
 					buttons: [...this._buttons],
 				},
-			},
-			{ ...options }
+			}, viewOnce ?? this._viewOnce),
+			{ ...buildOptions }
 		);
 		return msg;
 	}
@@ -963,23 +975,27 @@ export class Carousel extends BaseBuilder {
 	}
 
 	build(jid, { ...options } = {}) {
+		const { viewOnce, ...buildOptions } = options;
 		return generateWAMessageFromContent(
 			jid,
-			{
-				...this._extraPayload,
-				interactiveMessage: {
-					header: {
-						hasMediaAttachment: false,
-					},
-					body: { text: this._body },
-					footer: { text: this._footer },
-					contextInfo: this._contextInfo,
-					carouselMessage: {
-						cards: this._cards,
+			wrapViewOnce(
+				{
+					...this._extraPayload,
+					interactiveMessage: {
+						header: {
+							hasMediaAttachment: false,
+						},
+						body: { text: this._body },
+						footer: { text: this._footer },
+						contextInfo: this._contextInfo,
+						carouselMessage: {
+							cards: this._cards,
+						},
 					},
 				},
-			},
-			{ ...options }
+				viewOnce ?? this._viewOnce
+			),
+			{ ...buildOptions }
 		);
 	}
 

package/lib/Utils/messages.js

@@ -37,6 +37,7 @@ import {
   toBuffer,
 } from "./messages-media.js";
 import { shouldIncludeReportingToken } from "./reporting-utils.js";
+import { wrapViewOnce, isViewOnceContent, getInnerContentType, unwrapViewOnce } from "./view-once.js";
 import { isAnimatedWebP, isWebPBuffer, writeExif } from "./sticker-utils.js";
 const MIMETYPE_MAP = {
   image: "image/jpeg",
@@ -705,7 +706,12 @@ export const generateWAMessageContent = async (message, options) => {
   ) {
     // مضافة من مكتبة itsliaaa: رسالة Rich Response (Meta AI) — جداول/كود ملوّن
     m = prepareRichResponseMessage(message);
-  } else if (hasNonNullishProperty(message, "text")) {
+  } else if (
+    hasNonNullishProperty(message, "text") &&
+    // لو فيه أزرار (nativeFlow / buttons) الرسالة تفاعلية مش نص عادي
+    !hasNonNullishProperty(message, "nativeFlow") &&
+    !(Array.isArray(message.buttons) && message.buttons.length > 0)
+  ) {
     const extContent = { text: message.text };
     let urlInfo = message.linkPreview;
     if (typeof urlInfo === "undefined") {
@@ -1021,19 +1027,25 @@ export const generateWAMessageContent = async (message, options) => {
   } else {
     m = await prepareWAMessageMedia(message, options);
   }
-  if (
-    hasOptionalProperty(message, "viewOnce") &&
-    !!message.viewOnce &&
-    !m.viewOnceMessage
-  ) {
-    m = { viewOnceMessage: { message: m } };
+  // View-Once موحَّد (0.1.6): بيشتغل على أي نوع رسالة (مش صورة/فيديو/صوت بس)،
+  // من content.viewOnce أو options.viewOnce. رسايل التحكم (edit/react/delete...) بتتخطى.
+  {
+    const viewOnceFlag =
+      hasOptionalProperty(message, "viewOnce") && !!message.viewOnce
+        ? message.viewOnce
+        : options?.viewOnce;
+    if (viewOnceFlag && !hasNonNullishProperty(message, "edit") && !isViewOnceContent(m)) {
+      m = wrapViewOnce(m, viewOnceFlag);
+    }
   }
   if (
     (hasOptionalProperty(message, "mentions") && message.mentions?.length) ||
     (hasOptionalProperty(message, "mentionAll") && message.mentionAll)
   ) {
-    const target = m.viewOnceMessage ? m.viewOnceMessage.message : m;
-    const messageType = Object.keys(target)[0];
+    const target = unwrapViewOnce(m);
+    const messageType = isViewOnceContent(m)
+      ? getInnerContentType(target)
+      : Object.keys(target)[0];
     const key = target[messageType];
     if (key && "contextInfo" in key) {
       key.contextInfo = key.contextInfo || {};
@@ -1061,9 +1073,15 @@ export const generateWAMessageContent = async (message, options) => {
     };
   }
   if (hasOptionalProperty(message, "contextInfo") && !!message.contextInfo) {
-    const messageType = Object.keys(m)[0];
-    const key = m[messageType];
-    if ("contextInfo" in key && !!key.contextInfo) {
+    // لو الرسالة ملفوفة في viewOnce لازم نكتب الـ contextInfo على الرسالة الداخلية مش على الغلاف
+    const ctxTarget = isViewOnceContent(m) ? unwrapViewOnce(m) : m;
+    const messageType = isViewOnceContent(m)
+      ? getInnerContentType(ctxTarget)
+      : Object.keys(m)[0];
+    const key = ctxTarget[messageType];
+    if (!key) {
+      // مفيش نوع رسالة نكتب عليه contextInfo
+    } else if ("contextInfo" in key && !!key.contextInfo) {
       key.contextInfo = { ...key.contextInfo, ...message.contextInfo };
     } else if (key) {
       key.contextInfo = message.contextInfo;

package/lib/Utils/newsletter-status.js

@@ -85,12 +85,45 @@ const buildMetaNode = ({ interactionType, parentServerId, responseServerId, aiCo
 export const withNewsletterStatusAttribution = content => ({
     ...content,
     contextInfo: {
+        // matches the contextInfo of real channel statuses captured via getNewsletterStatuses
+        forwardingScore: 0,
         statusAttributions: [{ type: proto.StatusAttribution.Type.NEWSLETTER_STATUS }],
-        featureEligibilities: { canBeReshared: true },
+        featureEligibilities: { cannotBeRanked: false, canBeReshared: true, canReceiveMultiReact: true },
         ...(content?.contextInfo || {})
     }
 })
 
+const hasOwn = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key)
+
+// StatusSourceType: IMAGE 0, VIDEO 1, GIF 2, AUDIO 3, TEXT 4.  PairedMediaType: NOT_PAIRED_MEDIA 0.
+// Real statuses (captured from a live channel): text carries textArgb/backgroundArgb/font SYSTEM/previewType NONE
+// and statusSourceType TEXT; media carries pairedMediaType NOT_PAIRED_MEDIA and no statusSourceType.
+export const NATIVE_STATUS_TEXT_ARGB = 0xFFFFFFFF
+export const NATIVE_STATUS_BACKGROUND_ARGB = 0xFF8B6990
+
+export const applyNativeStatusShape = (message, { textArgb, backgroundArgb } = {}) => {
+    const content = normalizeMessageContent(message)
+    if (!content) return message
+
+    const text = content.extendedTextMessage
+    if (text) {
+        if (!hasOwn(text, 'textArgb')) text.textArgb = textArgb ?? NATIVE_STATUS_TEXT_ARGB
+        if (!hasOwn(text, 'backgroundArgb')) text.backgroundArgb = backgroundArgb ?? NATIVE_STATUS_BACKGROUND_ARGB
+        if (!hasOwn(text, 'font')) text.font = 0 // SYSTEM
+        text.previewType = 0 // NONE, even when a link preview was generated
+        text.contextInfo = text.contextInfo || {}
+        text.contextInfo.statusSourceType = 4 // TEXT
+        return message
+    }
+
+    const media = content.imageMessage || content.videoMessage || content.audioMessage
+    if (media) {
+        media.contextInfo = media.contextInfo || {}
+        media.contextInfo.pairedMediaType = 0 // NOT_PAIRED_MEDIA
+    }
+    return message
+}
+
 const snapshotCallbackNode = (event, node) => ({
     event,
     tag: node?.tag,
@@ -376,6 +409,8 @@ export const makeNewsletterStatusSender = (sock, config) => async (jid, content,
         interactionType: requestedInteractionType,
         aiContent,
         statusAttribution = true,
+        statusShape = 'native',
+        statusStyle,
         messageId: requestedMessageId,
         ackTimeoutMs,
         resolveServerId,
@@ -409,6 +444,8 @@ export const makeNewsletterStatusSender = (sock, config) => async (jid, content,
         messageId: requestedMessageId || generateMessageIDV2(userJid)
     })
 
+    if (statusAttribution && statusShape !== 'legacy') applyNativeStatusShape(fullMsg.message, statusStyle)
+
     const normalized = normalizeMessageContent(fullMsg.message)
     const mediaType = getNewsletterStatusMediaType(fullMsg.message)
     if (!mediaType && (normalized?.documentMessage || normalized?.stickerMessage)) {

package/lib/Utils/prototype-helpers.js

@@ -1,5 +1,5 @@
 /**
- * Prototype VIP Baileys Helpers (0.1.5)
+ * Prototype VIP Baileys Helpers (0.1.6)
  *
  * طبقة helpers سهلة فوق المسارات الأصلية الموجودة في المكتبة
  * (sock.sendMessage → nativeFlow / album / code / event / product ...).
@@ -8,6 +8,7 @@
 
 import { proto } from "../../WAProto/index.js";
 import { generateWAMessageFromContent } from "./messages.js";
+import { wrapViewOnce } from "./view-once.js";
 // الكلاسات دي مصدَّرة أصلاً من message-builder.js عن طريق Utils/index.js
 import { Button, ButtonV2, Carousel, AIRich, Toolkit } from "./message-builder.js";
 
@@ -26,6 +27,36 @@ const assertSock = (sock, method = "sendMessage") => {
   }
 };
 
+/** View-Once من content.viewOnce أو options.viewOnce (true | "v2" | "force" | {version,force}) */
+const pickViewOnce = (content, options) => content?.viewOnce ?? options?.viewOnce;
+
+const MIME_BY_EXT = {
+  pdf: "application/pdf",
+  zip: "application/zip",
+  rar: "application/vnd.rar",
+  "7z": "application/x-7z-compressed",
+  txt: "text/plain",
+  json: "application/json",
+  csv: "text/csv",
+  html: "text/html",
+  js: "text/javascript",
+  apk: "application/vnd.android.package-archive",
+  doc: "application/msword",
+  docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  xls: "application/vnd.ms-excel",
+  xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  ppt: "application/vnd.ms-powerpoint",
+  pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  mp3: "audio/mpeg",
+  mp4: "video/mp4",
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  webp: "image/webp",
+};
+
+const mimeFromName = (name = "") => MIME_BY_EXT[String(name).split("?")[0].split(".").pop()?.toLowerCase()] || "application/octet-stream";
+
 const defaultRowId = (label) => `#${String(label || "row").trim().replace(/\s+/g, "_")}`;
 
 /**
@@ -140,7 +171,7 @@ export async function sendList(sock, jid, content = {}, options = {}) {
   if (legacy) {
     const msg = generateWAMessageFromContent(
       jid,
-      {
+      wrapViewOnce({
         listMessage: {
           title,
           description: text,
@@ -156,7 +187,7 @@ export async function sendList(sock, jid, content = {}, options = {}) {
             })),
           })),
         },
-      },
+      }, pickViewOnce(content, options)),
       { userJid: sock.user?.id, quoted: options.quoted, messageId: options.messageId }
     );
     const additionalNodes = isPrivateJid(jid)
@@ -232,7 +263,8 @@ export async function sendAlbum(sock, jid, mediaItems = [], options = {}) {
     expectedImageCount: mediaItems.filter((i) => i.image).length,
     expectedVideoCount: mediaItems.filter((i) => i.video).length,
   });
-  return sock.sendMessage(jid, { album }, options);
+  const { viewOnce, ...sendOptions } = options;
+  return sock.sendMessage(jid, { album, ...(viewOnce ? { viewOnce } : {}) }, sendOptions);
 }
 
 /* ───────────────────────────── carousel ───────────────────────────── */
@@ -255,6 +287,8 @@ export async function sendCarousel(sock, jid, content = {}, options = {}) {
 
   const carousel = new Carousel(sock).setBody(text);
   if (footer) carousel.setFooter(footer);
+  const viewOnce = pickViewOnce(content, options);
+  if (viewOnce) carousel.setViewOnce(viewOnce);
 
   for (const [i, card] of cards.entries()) {
     const media = card.image ?? card.video;
@@ -275,7 +309,8 @@ export async function sendCarousel(sock, jid, content = {}, options = {}) {
     carousel.addCard(await b.toCard());
   }
 
-  await carousel.send(jid, { userJid: sock.user?.id, ...options });
+  const { viewOnce: _vo, ...sendOptions } = options;
+  return carousel.send(jid, { userJid: sock.user?.id, ...sendOptions });
 }
 
 /* ───────────────────────────── rich (AI) ───────────────────────────── */
@@ -328,10 +363,89 @@ export async function sendRichCode(sock, jid, { code, language = "javascript", t
 
 /* ───────────────────────────── misc senders ───────────────────────────── */
 
+/**
+ * View-Once لأي نوع رسالة (0.1.6) — مش صورة/فيديو/صوت بس:
+ *   نص، ملف، أزرار، قائمة، كاروسيل، ألبوم، منتج، لوكيشن، جهة اتصال، Rich ...
+ *
+ *   await sendViewOnce(sock, jid, { image: { url }, caption: "x" })
+ *   await sendViewOnce(sock, jid, { text: "x", buttons: [...] })          // → sendButtons
+ *   await sendViewOnce(sock, jid, { text: "x", sections: [...] })         // → sendList
+ *   await sendViewOnce(sock, jid, { text: "x", cards: [...] })            // → sendCarousel
+ *   await sendViewOnce(sock, jid, [{ image }, { video }])                 // → sendAlbum
+ *   options.viewOnce = true | "v2" | "force"  (الافتراضي true)
+ */
 export async function sendViewOnce(sock, jid, content, options = {}) {
   assertSock(sock);
+  const flag = (typeof content === "object" && !Array.isArray(content) && content?.viewOnce) || options.viewOnce || true;
+  const opts = { ...options, viewOnce: flag };
+
+  if (Array.isArray(content)) return sendAlbum(sock, jid, content, opts);
+
+  const payload = typeof content === "string" ? { text: content } : { ...content };
+  delete payload.viewOnce;
+
+  if (Array.isArray(payload.cards)) return sendCarousel(sock, jid, payload, opts);
+  if (Array.isArray(payload.sections)) return sendList(sock, jid, payload, opts);
+  if (Array.isArray(payload.buttons) && payload.buttons.length) return sendButtons(sock, jid, payload, opts);
+  return sock.sendMessage(jid, { ...payload, viewOnce: flag }, options);
+}
+
+/* ───────────────────────────── extras (0.1.6) ───────────────────────────── */
+
+/**
+ * ملف/مستند. source: { url } | Buffer | رابط نصي | { document, fileName, mimetype, caption }
+ *   await sendDocument(sock, jid, { url: "https://x/a.pdf", fileName: "a.pdf", caption: "تفضل" }, { viewOnce: true })
+ */
+export async function sendDocument(sock, jid, content = {}, options = {}) {
+  assertSock(sock);
+  const src = typeof content === "string" ? { url: content } : Buffer.isBuffer(content) ? { document: content } : { ...content };
+  const doc = src.document ?? src.file ?? src.buffer ?? (src.url ? { url: src.url } : undefined);
+  if (!doc) throw new Error("sendDocument requires document | file | buffer | url");
+  const document = typeof doc === "string" ? { url: doc } : doc;
+  const urlLike = document?.url || (typeof src.url === "string" ? src.url : "");
+  const fileName = src.fileName || src.filename || src.name || (urlLike ? String(urlLike).split("?")[0].split("/").pop() : "file");
+  const mimetype = src.mimetype || src.mime || mimeFromName(fileName);
+  const { caption, text } = src;
+  return sock.sendMessage(
+    jid,
+    { document, fileName, mimetype, ...(caption || text ? { caption: caption ?? text } : {}) },
+    options
+  );
+}
+
+/** تعديل رسالة بعتّها قبل كده (نص/كابشن) */
+export async function sendEdit(sock, jid, key, content, options = {}) {
+  assertSock(sock);
+  if (!key) throw new Error("sendEdit requires the original message key");
   const payload = typeof content === "string" ? { text: content } : { ...content };
-  return sock.sendMessage(jid, { ...payload, viewOnce: true }, options);
+  return sock.sendMessage(jid, { ...payload, edit: key }, options);
+}
+
+/** حذف رسالة للكل */
+export async function sendDelete(sock, jid, key) {
+  assertSock(sock);
+  if (!key) throw new Error("sendDelete requires the message key");
+  return sock.sendMessage(jid, { delete: key });
+}
+
+/**
+ * يبعت بعد ما يعمل "بيكتب..." (أو "بيسجل..." لو recording) لمدة typingMs
+ *   await sendWithTyping(sock, jid, { text: "أهلا" }, { typingMs: 1200 })
+ */
+export async function sendWithTyping(sock, jid, content, options = {}) {
+  assertSock(sock);
+  const { typingMs = 1000, presence = "composing", ...sendOptions } = options;
+  const canPresence = typeof sock.sendPresenceUpdate === "function";
+  try {
+    if (canPresence) {
+      await sock.sendPresenceUpdate(presence, jid);
+      await new Promise((r) => setTimeout(r, Math.max(0, Number(typingMs) || 0)));
+    }
+    const payload = typeof content === "string" ? { text: content } : content;
+    return await sock.sendMessage(jid, payload, sendOptions);
+  } finally {
+    if (canPresence) await sock.sendPresenceUpdate("paused", jid).catch(() => {});
+  }
 }
 
 export async function sendReaction(sock, jid, key, emoji = "👍") {
@@ -553,6 +667,10 @@ export function attachPrototypeHelpers(sock) {
   sock.sendQuickButtons = (jid, text, labels, opts) => sendQuickButtons(sock, jid, text, labels, opts);
   sock.sendCarousel = (jid, content, opts) => sendCarousel(sock, jid, content, opts);
   sock.sendViewOnce = (jid, content, opts) => sendViewOnce(sock, jid, content, opts);
+  sock.sendDocument = (jid, content, opts) => sendDocument(sock, jid, content, opts);
+  sock.sendEdit = (jid, key, content, opts) => sendEdit(sock, jid, key, content, opts);
+  sock.sendDelete = (jid, key) => sendDelete(sock, jid, key);
+  sock.sendWithTyping = (jid, content, opts) => sendWithTyping(sock, jid, content, opts);
   sock.sendReaction = (jid, key, emoji) => sendReaction(sock, jid, key, emoji);
   sock.sendPoll = (jid, name, values, opts) => sendPoll(sock, jid, name, values, opts);
   sock.sendMentionAll = (jid, text, opts) => sendMentionAll(sock, jid, text, opts);
@@ -592,6 +710,10 @@ export default {
   sendQuickButtons,
   sendCarousel,
   sendViewOnce,
+  sendDocument,
+  sendEdit,
+  sendDelete,
+  sendWithTyping,
   sendReaction,
   sendPoll,
   sendMentionAll,

package/lib/Utils/view-once.js

@@ -0,0 +1,160 @@
+/**
+ * View-Once موحَّد (0.1.6)
+ *
+ * نقطة واحدة بتلفّ أي محتوى رسالة (نص / صورة / فيديو / صوت / ملف / أزرار / قوائم /
+ * كاروسيل / منتج / لوكيشن / جهة اتصال / Rich ...) جوه viewOnceMessage.
+ * الدوال دي مفيهاش أي dependency خارجي عشان تتستعمل من messages.js و
+ * messages-send.js و message-builder.js و prototype-helpers.js من غير circular imports.
+ *
+ * طرق التفعيل (كلها بتدخل على نفس الدالة):
+ *   sock.sendMessage(jid, { ...content, viewOnce: true })
+ *   sock.sendMessage(jid, content, { viewOnce: true })
+ *   sock.sendButtons / sendList / sendCarousel / sendAlbum / ... (jid, content, { viewOnce: true })
+ *   new Carousel(sock).setViewOnce()  /  new Button(sock).setViewOnce()
+ *
+ * قيم الـ flag:
+ *   true | "v1"            → viewOnceMessage            (الافتراضي — نفس السلوك القديم)
+ *   "v2" | 2               → viewOnceMessageV2
+ *   "force" | "v2-force"   → نفس اللي فوق، بس بيلف حتى الأنواع اللي مش مدعومة رسمياً (استيكر / استطلاع / ألبوم)
+ *   { version: 1|2, force: boolean }
+ */
+
+export const VIEW_ONCE_KEYS = ["viewOnceMessage", "viewOnceMessageV2", "viewOnceMessageV2Extension"];
+
+/** رسائل تحكّم/بروتوكول: مينفعش تتلف في viewOnce أبداً (حتى مع force) */
+const NEVER_WRAP = new Set([
+  "protocolMessage",
+  "reactionMessage",
+  "encReactionMessage",
+  "pollUpdateMessage",
+  "encEventResponseMessage",
+  "keepInChatMessage",
+  "pinInChatMessage",
+  "buttonsResponseMessage",
+  "listResponseMessage",
+  "interactiveResponseMessage",
+  "templateButtonReplyMessage",
+  "senderKeyDistributionMessage",
+  "editedMessage",
+  "ephemeralMessage",
+  "groupStatusMessage",
+  "groupStatusMessageV2",
+  "associatedChildMessage",
+  "documentWithCaptionMessage",
+]);
+
+/** أنواع واتساب نفسه مبيعرضهاش كـ view-once → بتتخطى إلا مع force */
+const UNSUPPORTED_UNLESS_FORCED = new Set([
+  "albumMessage",
+  "stickerMessage",
+  "stickerPackMessage",
+  "pollCreationMessage",
+  "pollCreationMessageV2",
+  "pollCreationMessageV3",
+  "pollCreationMessageV5",
+  "pollCreationMessageV6",
+  "requestPhoneNumberMessage",
+]);
+
+/** أنواع تفاعلية: واتساب بيطلب messageContextInfo جوه الـ viewOnce عشان تتعرض */
+const INTERACTIVE_TYPES = new Set([
+  "interactiveMessage",
+  "buttonsMessage",
+  "listMessage",
+  "templateMessage",
+  "productMessage",
+  "eventMessage",
+  "richResponseMessage",
+]);
+
+/** ميديا بيحطلها واتساب نفسه viewOnce=true جوه الرسالة كمان (مش الغلاف بس) */
+const MEDIA_TYPES = new Set(["imageMessage", "videoMessage", "audioMessage"]);
+
+/** نفس منطق getContentType (متكرر هنا عشان مفيش import دائري) */
+export function getInnerContentType(content) {
+  if (!content || typeof content !== "object") return undefined;
+  return Object.keys(content).find(
+    (k) => (k === "conversation" || k.includes("Message")) && k !== "senderKeyDistributionMessage" && content[k] != null
+  );
+}
+
+/** يحوّل أي صيغة flag لـ { key, force } أو null لو مفيش viewOnce */
+export function parseViewOnce(flag) {
+  if (!flag) return null;
+  if (flag === true || flag === "v1" || flag === 1) return { key: "viewOnceMessage", force: false };
+  if (flag === "v2" || flag === 2) return { key: "viewOnceMessageV2", force: false };
+  if (flag === "force") return { key: "viewOnceMessage", force: true };
+  if (flag === "v2-force") return { key: "viewOnceMessageV2", force: true };
+  if (typeof flag === "object") {
+    return {
+      key: Number(flag.version) === 2 || flag.version === "v2" ? "viewOnceMessageV2" : "viewOnceMessage",
+      force: !!flag.force,
+    };
+  }
+  return { key: "viewOnceMessage", force: false }; // أي قيمة truthy تانية
+}
+
+export const isViewOnceContent = (content) => !!content && VIEW_ONCE_KEYS.some((k) => content[k]);
+
+/** يرجّع المحتوى الداخلي لو ملفوف في viewOnce، وإلا نفس المحتوى */
+export function unwrapViewOnce(content) {
+  if (!content) return content;
+  for (const k of VIEW_ONCE_KEYS) {
+    if (content[k]?.message) return content[k].message;
+  }
+  return content;
+}
+
+/**
+ * يلف محتوى الرسالة (شكل proto: { xxxMessage: {...} }) في viewOnce.
+ *  - idempotent: لو الرسالة ملفوفة أصلاً بيرجّعها زي ما هي.
+ *  - بيتخطى رسائل التحكم (react / delete / edit / poll vote ...) دايماً.
+ *  - بيتخطى الاستيكر/الاستطلاع/الألبوم إلا مع "force".
+ *  - بيضيف messageContextInfo الداخلي للأنواع التفاعلية (أزرار/قوائم/كاروسيل...).
+ */
+export function wrapViewOnce(content, flag = true) {
+  const opt = parseViewOnce(flag);
+  if (!opt || !content || typeof content !== "object") return content;
+  if (isViewOnceContent(content)) return content;
+
+  const type = getInnerContentType(content);
+  if (!type) return content;
+  if (NEVER_WRAP.has(type)) return content;
+  if (UNSUPPORTED_UNLESS_FORCED.has(type) && !opt.force) return content;
+
+  const inner = { ...content };
+  if (MEDIA_TYPES.has(type) && inner[type] && typeof inner[type] === "object") {
+    inner[type].viewOnce = true;
+  }
+  if (INTERACTIVE_TYPES.has(type) && !inner.messageContextInfo) {
+    inner.messageContextInfo = { deviceListMetadata: {}, deviceListMetadataVersion: 2 };
+  }
+  return { [opt.key]: { message: inner } };
+}
+
+/** هل النوع ده بيتلف فعلاً مع الـ flag ده؟ (للتشخيص / الاختبارات) */
+export function canWrapViewOnce(content, flag = true) {
+  const opt = parseViewOnce(flag);
+  if (!opt) return false;
+  const type = getInnerContentType(unwrapViewOnce(content));
+  if (!type || NEVER_WRAP.has(type)) return false;
+  return opt.force || !UNSUPPORTED_UNLESS_FORCED.has(type);
+}
+
+/** يجيب نوع المحتوى الحقيقي + المحتوى نفسه حتى لو ملفوف في viewOnce */
+export function getViewOnceTarget(content) {
+  const inner = unwrapViewOnce(content);
+  const type = getInnerContentType(inner) ?? Object.keys(inner || {})[0];
+  return { inner, type, node: type ? inner?.[type] : undefined };
+}
+
+export default {
+  VIEW_ONCE_KEYS,
+  parseViewOnce,
+  wrapViewOnce,
+  unwrapViewOnce,
+  isViewOnceContent,
+  canWrapViewOnce,
+  getInnerContentType,
+  getViewOnceTarget,
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@prototypevip/baileys",
-  "version": "0.1.5",
-  "description": "Baileys fork (@prototypevip/baileys) — clean + Channel/Group/Personal Status + Interactive Buttons/Lists/Album/Carousel + Rich code responses + Call Invites helpers (0.1.5)",
+  "version": "0.1.6",
+  "description": "Baileys fork (@prototypevip/baileys) — clean + Channel/Group/Personal Status + Interactive Buttons/Lists/Album/Carousel + Rich code responses + Call Invites + Universal View-Once (0.1.6)",
   "main": "lib/index.js",
   "type": "module",
   "scripts": {
@@ -24,24 +24,26 @@
     "HELPERS.md"
   ],
   "keywords": [
+    "album",
     "automation",
     "baileys",
     "baileys-fork",
     "baileys-mod",
+    "buttons",
+    "call-invite",
+    "interactive-messages",
     "js-whatsapp",
     "multi-device",
+    "native-flow",
+    "rich-response",
+    "view-once",
+    "viewonce",
     "whatsapp",
     "whatsapp-api",
     "whatsapp-bot",
     "whatsapp-chat",
     "whatsapp-group",
-    "whatsapp-web",
-    "interactive-messages",
-    "buttons",
-    "album",
-    "native-flow",
-    "call-invite",
-    "rich-response"
+    "whatsapp-web"
   ],
   "homepage": "https://github.com/GSK-F/baileys",
   "author": "The Prototype",