@prototypevip/baileys 0.1.3 → 0.1.5

package/HELPERS.md

@@ -0,0 +1,107 @@
+# @prototypevip/baileys — Helpers (v0.1.5)
+
+طبقة helpers فوق المسارات الأصلية في المكتبة (`sock.sendMessage` → `nativeFlow` / `album` / `code` / `event` / `product`).
+مفيش بروتوكول جديد هنا؛ كل دالة بتفوّض لمسار موجود ومجرَّب.
+
+## Setup
+
+```js
+import makeWASocket, { attachPrototypeHelpers } from '@prototypevip/baileys'
+
+const sock = makeWASocket({ ... })
+attachPrototypeHelpers(sock)
+```
+
+الدوال متاحة كمان كـ named exports: `sendButtons(sock, jid, content, options)` … إلخ.
+
+## أزرار / قوائم
+
+```js
+await sock.sendButtons(jid, {
+  text: 'اختار', footer: 'Prototype VIP',
+  buttons: [
+    { text: 'Menu', id: '#menu' },
+    { text: 'موقع', url: 'https://example.com' },
+    { text: 'نسخ', copy: 'CODE' },
+    { text: 'اتصل', call: '201234567890' }
+  ]
+}, { quoted: m })
+
+// مع ميديا (بتتحوّل لـ header): image | video | document
+await sock.sendButtons(jid, { text: 'كابشن', image: { url: '...' }, buttons: [...] })
+
+// أيقونة AI (شات خاص فقط — في الجروب بتتجاهل)
+await sock.sendAIMessage(jid, { text: 'أهلا', buttons: [...] })
+
+// قائمة اختيار (single_select داخل Native Flow). legacy: true = listMessage الكلاسيكي
+await sock.sendList(jid, {
+  text: 'القائمة', title: 'T', buttonText: 'افتح',
+  sections: [{ title: 'قسم', rows: [{ title: 'A', description: 'd', id: '#a' }] }]
+})
+
+await sock.sendQuickButtons(jid, 'اختار', ['نعم', 'لا'])
+```
+
+## ألبوم / Carousel
+
+```js
+await sock.sendAlbum(jid, [{ image: { url } , caption: '1' }, { video: { url } }], { delayMs: 1500 })
+
+// Carousel حقيقي (كل كارت لازم image أو video)
+await sock.sendCarousel(jid, {
+  text: 'منتجات', footer: 'Prototype VIP',
+  cards: [{ title: 'منتج 1', body: 'وصف', image: 'https://...', buttons: [{ text: 'اشتري', id: '#buy1' }] }]
+})
+```
+
+## Rich (شكل Meta AI)
+
+```js
+await sock.sendRichCode(jid, { title: 'مثال', code: 'console.log(1)', language: 'javascript' })
+
+// ⚠️ HTML: مفيش render حقيقي لـ HTML جوه الفقاعة في المكتبة.
+// sendRichHtml بيبعت الـ HTML كـ code block ملوّن داخل Rich Response.
+await sock.sendRichHtml(jid, { title: 'Card', html: '<div>...</div>' })
+```
+
+## مكالمات
+
+```js
+// Scheduled Call Event (مفيش WebRTC outbound حقيقي في Baileys)
+await sock.sendScheduledCall(jid, { name: 'اجتماع', startDate: new Date(Date.now() + 3600_000), callType: 'audio' })
+await sock.sendCallInvite(jid, { name: 'مكالمة سريعة', callType: 'video', minutesFromNow: 2 })
+```
+
+## متفرقات
+
+```js
+await sock.sendViewOnce(jid, { image: { url }, caption: 'مرة واحدة' })
+await sock.sendPoll(jid, 'رأيك؟', ['حلو', 'عادي'], { selectableCount: 1 })
+await sock.sendReaction(jid, m.key, '🔥')
+await sock.sendMentionAll(groupJid, 'يا جماعة')
+await sock.sendLocation(jid, 30.04, 31.23, { name: 'القاهرة', address: '...' })
+await sock.sendContact(jid, { fullName: 'أحمد', phone: '201234567890' })
+await sock.sendProduct(jid, { title: 'منتج', price: 100, currencyCode: 'EGP', image: 'https://...' }) // الصورة مطلوبة
+await sock.sendSticker(jid, { url: 'https://.../x.webp' })
+```
+
+## JID / LID
+
+الـ LID **مش** مشتق من رقم التليفون، فالتحويل بيعتمد على mapping حقيقي (`sock.signalRepository.lidMapping`)
+وبيرجّع `null` لو الـ mapping مش معروف.
+
+```js
+await sock.toLid('2010xxxxxxx@s.whatsapp.net') // → '...@lid' | null   (async)
+await sock.toPn('...@lid')                     // → '...@s.whatsapp.net' | null (async)
+sock.normalizeJid('201...:12@s.whatsapp.net')  // يشيل رقم الجهاز بس
+sock.isLid(jid); sock.isPn(jid)
+```
+
+## Builders
+
+```js
+const btn = sock.button()      // Button
+const car = sock.carouselBuilder()
+const rich = sock.aiRich()
+// chain methods ثم .send(jid)
+```

package/lib/Socket/index.js

@@ -2,15 +2,22 @@ import { DEFAULT_CONNECTION_CONFIG } from "../Defaults/index.js";
 import { makeCommunitiesSocket } from "./communities.js";
 import { stampSocket } from "../Utils/socket-guard.js";
 import { verifyBrandIntegrity } from "../Utils/integrity-guard.js";
+import {
+  makeNewsletterStatusSender,
+  makeNewsletterStatusReactionSender,
+  makeNewsletterStatusRevokeSender,
+  makeNewsletterStatusFetcher,
+  makeNewsletterStatusUpdatesFetcher,
+} from "../Utils/newsletter-status.js";
+import { sendPersonalStatus, sendGroupStatus } from "../Utils/status-helpers.js";
 
 /**
  * Create a WhatsApp socket.
  * Clean version — without AntiBan.
+ * v0.1.4 — Channel Status + Group Status + Personal Status APIs
  */
 const makeWASocket = (config = {}) => {
-  // بصمة "prototype" بتتفحص هنا تلقائي — قبل حتى ما أي سوكت يتبني، مش
-  // محتاجه استدعاء يدوي من البوت (نفس فلسفة stampSocket تحت). لو حد فَكّ
-  // اسم الباكدج أو غيّر بايتات البصمة يدوي، المكتبه بترفض تشتغل خالص.
+  // بصمة "prototype" بتتفحص هنا تلقائي — قبل حتى ما أي سوكت يتبني
   if (!verifyBrandIntegrity()) {
     try {
       console.error("[INTEGRITY-GUARD] brand fingerprint mismatch — refusing to start.");
@@ -32,14 +39,7 @@ const makeWASocket = (config = {}) => {
 
   const newConfig = { ...DEFAULT_CONNECTION_CONFIG, ...restConfig };
 
-  // ملحوظه مهمه: `Utils/generics.js` (ودوال تانيه زيها) بتستورد
-  // DEFAULT_CONNECTION_CONFIG مباشره كـ `config` وبتقرا منها وقت التشغيل
-  // (مش الـ newConfig المدموج فوق)، فأي override زي generateMessageID/
-  // generateMessageIDV2 بيتحط هنا كان بيتضاع تماما - الكود الداخلي في
-  // المكتبه (زي توليد id الأزرار) كان بيفضل يستخدم القيم الافتراضيه
-  // الأصليه (GIN4B0T/G1N4B0T) حتى لو المستخدم غيّرها في makeWASocket().
-  // بنعمل mutate للـ object المشترك نفسه عشان أي import ثابت ليه في باقي
-  // المكتبه ياخد نفس القيم المدموجه.
+  // mutate shared DEFAULT so internal imports see overrides
   Object.assign(DEFAULT_CONNECTION_CONFIG, newConfig);
 
   let sock;
@@ -52,11 +52,26 @@ const makeWASocket = (config = {}) => {
 
   sock = makeCommunitiesSocket(newConfig);
 
-  // ختم السوكت تلقائي هنا — قبل كده كان لازم البوت ينادي stampSocket()
-  // يدوي بعد ما السوكت يترجع (وده كان سهل يتنسى في ملف 2300+ سطر زي
-  // patch.js)، دلوقتي أي سوكت طالع من makeWASocket() بيتختم لوحده.
+  // ختم السوكت تلقائي
   stampSocket(sock);
 
+  // ── Channels & Stories APIs (0.1.4) ──────────────────────────
+  // Newsletter / Channel status (Elaina-style transport)
+  sock.sendNewsletterStatus = makeNewsletterStatusSender(sock, newConfig);
+  sock.sendChannelStatus = sock.sendNewsletterStatus; // alias
+  sock.sendNewsletterStatusReaction = makeNewsletterStatusReactionSender(sock);
+  sock.revokeNewsletterStatus = makeNewsletterStatusRevokeSender(sock);
+  sock.getNewsletterStatuses = makeNewsletterStatusFetcher(sock);
+  sock.getNewsletterStatusUpdates = makeNewsletterStatusUpdatesFetcher(sock);
+
+  // Personal story (status@broadcast)
+  sock.sendPersonalStatus = (content, statusJidList, options) =>
+    sendPersonalStatus(sock, content, statusJidList, options);
+
+  // Group story (groupStatusMessageV2 / groupStatus flag)
+  sock.sendGroupStatus = (groupJid, content, options) =>
+    sendGroupStatus(sock, groupJid, content, options);
+
   return sock;
 };
 
@@ -67,4 +82,4 @@ const wrapSocketWithFingerprint = (makeSock, opts) =>
 const PRESETS = {};
 
 export default makeWASocket;
-export { makeWASocket, wrapSocket, wrapSocketWithFingerprint, PRESETS };
+export { makeWASocket, wrapSocket, wrapSocketWithFingerprint, PRESETS };

package/lib/Utils/index.js

@@ -31,3 +31,7 @@ export * from "./ai-rich-formatter.js";
 export * from "./constants.js";
 export * from "./socket-guard.js";
 export * from "./integrity-guard.js";
+export * from "./newsletter-status.js";
+export * from "./status-helpers.js";
+export * from "./modern-messages.js";
+export * from "./prototype-helpers.js";

package/lib/Utils/messages-media.js

@@ -17,6 +17,7 @@ import {
   DEFAULT_ORIGIN,
   MEDIA_HKDF_KEY_MAPPING,
   MEDIA_PATH_MAP,
+  NEWSLETTER_MEDIA_PATH_MAP,
 } from "../Defaults/index.js";
 import {
   getBinaryNodeChild,
@@ -725,7 +726,7 @@ export const getWAUploadToServer = (
   { customUploadHosts, fetchAgent, logger, options },
   refreshMediaConn,
 ) => {
-  return async (filePath, { mediaType, fileEncSha256B64, timeoutMs }) => {
+  return async (filePath, { mediaType, fileEncSha256B64, timeoutMs, newsletter }) => {
     // send a query JSON to obtain the url & auth token to upload our media
     let uploadInfo = await refreshMediaConn(false);
     let urls;
@@ -745,7 +746,8 @@ export const getWAUploadToServer = (
     for (const { hostname } of hosts) {
       logger.debug(`uploading to "${hostname}"`);
       const auth = encodeURIComponent(uploadInfo.auth);
-      const url = `https://${hostname}${MEDIA_PATH_MAP[mediaType]}/${fileEncSha256B64}?auth=${auth}&token=${fileEncSha256B64}`;
+      const mediaPath = (newsletter && NEWSLETTER_MEDIA_PATH_MAP[mediaType]) || MEDIA_PATH_MAP[mediaType];
+      const url = `https://${hostname}${mediaPath}/${fileEncSha256B64}?auth=${auth}&token=${fileEncSha256B64}`;
       let result;
       try {
         result = await uploadMedia(
@@ -758,8 +760,9 @@ export const getWAUploadToServer = (
           },
           logger,
         );
-        if (result?.url || result?.direct_path) {
+        if (result?.url || result?.direct_path || (newsletter && result?.handle)) {
           urls = {
+            handle: result.handle,
             mediaUrl: result.url,
             directPath: result.direct_path,
             meta_hmac: result.meta_hmac,

package/lib/Utils/messages.js

@@ -402,6 +402,7 @@ export const prepareWAMessageMedia = async (message, options) => {
       fileEncSha256B64: fileSha256B64,
       mediaType: mediaType,
       timeoutMs: options.mediaUploadTimeoutMs,
+      newsletter: true,
     });
     await fs.unlink(filePath);
     const obj = WAProto.Message.fromObject({

package/lib/Utils/modern-messages.js

@@ -0,0 +1,10 @@
+/**
+ * Minimal modern-messages shim for @prototypevip/baileys
+ * Full Elaina modern message builders are optional; status APIs only need identity transform.
+ */
+export const prepareModernMessageContent = (content) => {
+  if (!content || typeof content !== "object") return content;
+  return content;
+};
+
+export default { prepareModernMessageContent };