@prototypevip/baileys 0.1.4 → 0.1.6

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.4",
-  "description": "Baileys fork (@prototypevip/baileys) — clean + Channel/Group/Personal Status APIs (0.1.4)",
+  "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": {
@@ -20,15 +20,24 @@
   "files": [
     "lib/**/*",
     "WAProto/**/*",
-    "engine-requirements.js"
+    "engine-requirements.js",
+    "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",