plogme 2.1.0 → 2.1.2

package/lib/WAUSync/index.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/WAUSync/index.js
+ * About: WAUSync module for the Plogme WhatsApp protocol client.
+ * Important exports: No public exports detected; module side effects or declarations are local.
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 export * from './Protocols/index.js';
 export * from './USyncQuery.js';
 export * from './USyncUser.js';

package/lib/index.d.ts

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/index.d.ts
+ * About: Index.d module for the Plogme WhatsApp protocol client.
+ * Important exports: WAMessageKey, StatusOptions, PollVoteEvent, StatusContent, GroupStatusContent, StatusPrivacyList, StatusCustomList, BroadcastListQuota; …
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 export interface WAMessageKey {
     remoteJid?: string | null;
     fromMe?: boolean | null;
@@ -50,6 +62,8 @@ export interface StatusContent {
 
 export interface GroupStatusContent extends StatusContent {
     groupStatus: true;
+    /** Select the legacy groupStatusMessage envelope for compatibility testing. */
+    groupStatusVersion?: 'legacy' | 'v1' | 'v2';
 }
 
 /** One status distribution list entry as returned by `getStatusPrivacy`. */
@@ -390,8 +404,35 @@ export interface MetaCompositedOptions {
 export declare function editMetaMessage(sock: WASocket, jid: string, key: WAMessageKey, content: Record<string, unknown>, sendOptions?: Record<string, unknown>, streamContext?: Record<string, unknown>): Promise<unknown>;
 export declare function sendMetaComposited(sock: WASocket, jid: string, content: Record<string, unknown>, options?: MetaCompositedOptions): Promise<unknown>;
 
+export type PlogmeSimpleTable = unknown[][];
+export interface PlogmeRichTable {
+    title?: string;
+    headers: unknown[];
+    rows: unknown[][];
+    headerText?: string;
+    footer?: string;
+}
+export type PlogmeTableInput = PlogmeSimpleTable | PlogmeRichTable;
+export interface PlogmeMessageContent extends Record<string, unknown> {
+    table?: PlogmeTableInput;
+    richTable?: PlogmeRichTable;
+    tables?: PlogmeTableInput[];
+}
+
 export interface WASocket {
     sendMessage(jid: string | string[], content: StatusContent | GroupStatusContent | Record<string, unknown>, options?: Partial<StatusOptions> & Record<string, unknown>): Promise<unknown>;
+    /** Send legacy reply buttons with one optional image, video, document, or location header. */
+    replyButton(jid: string, buttons: Array<Record<string, unknown>>, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a file; set photo_live to send it as an associated still-image/motion-video pair. */
+    sendFile(jid: string, media: unknown, filename?: string, caption?: string, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a motion photo from a video, optionally supplying its still image or thumbnail. */
+    sendPhotoLive(jid: string, content: { video: unknown; image?: unknown; thumbnail?: unknown; videoThumbnail?: Uint8Array; imageThumbnail?: Uint8Array; caption?: string; text?: string; motionPhotoPresentationOffsetMs?: number; presentationOffsetMs?: number }, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send or edit a textual progress bar. Set messageKey to update a prior progress message. */
+    sendProgress(jid: string, text: string, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send text with an external preview card using custom URL, title, thumbnail, and attribution. */
+    sendMessageModify(jid: string, text: string, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Compatibility alias for sendMessageModify. */
+    sendMessageModifyV2(jid: string, text: string, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
     /** Send at least two image/video URL items as a full-width AIRich vertical album. */
     sendAlbumMessage(jid: string, medias: AlbumMediaInput[], options?: Record<string, unknown>): Promise<unknown>;
     /** Send an AIRich unified-response grid of GenAIVideoPrimitive items. Requires at least two video URLs. */
@@ -464,8 +505,12 @@ export interface WASocket {
     sendBotPlanning(jid: string, content?: { text?: string; steps?: Array<string | { title?: string; name?: string; body?: string }>; queryPlan?: boolean; botJid?: string }, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a rich response with experimental resolved tool-call metadata. */
     sendBotToolResult(jid: string, content?: { text?: string; toolCallId?: string; resolutionData?: unknown; resolutionDataSerialized?: string; botJid?: string }, options?: Record<string, unknown>): Promise<unknown>;
-    /** Send one tolerant AIRich response containing every supported section supplied in content. */
-    sendPlogmeMessage(jid: string, content?: Record<string, unknown>, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send one tolerant AIRich response, including simple or rich-preview tables in caller order. */
+    sendPlogmeMessage(jid: string, content?: PlogmeMessageContent, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send rich media using both native Plogme primitives and the additive New compatibility-compatible shape. */
+    sendNewRichMedia(jid: string, content?: Record<string, unknown>, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a native group status with optional private named-audience metadata. */
+    sendGroupStatus(jid: string, content: Record<string, unknown>, options?: { private?: { name?: string; emoji?: string }; [key: string]: unknown }): Promise<unknown>;
     /** Send a compact forwarded AIRich label bubble with optional colors and variant. */
     sendRichLabelMessage(jid: string, content?: { text?: string; variant?: string; backgroundColor?: string; textColor?: string; responseId?: string }, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
     /** Send a prompt through the verified Meta AI/Hatch route and return its message ID. */
@@ -488,6 +533,9 @@ export interface WASocket {
     updateRichGeneration(jid: string, targetId: string, content?: RichGenerationContent, options?: Record<string, unknown>): Promise<RichGenerationResult>;
     /** Send a carousel-style rich grid where each card exposes native reply buttons. */
     sendRichButtonGrid(jid: string, grid: { text?: string; footer?: string; cards: Array<{ title?: string; caption?: string; image?: unknown; buttons?: Array<{ id?: string; text?: string; buttonText?: string; url?: string; call?: string; copy?: string; sections?: unknown[] }>; nativeFlow?: unknown[] }> }, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a native WhatsApp carousel; accepts either options or quoted, options after the card list. */
+    sendCarousel(jid: string, cards: Array<Record<string, unknown>>, options?: Record<string, unknown>): Promise<unknown>;
+    sendCarousel(jid: string, cards: Array<Record<string, unknown>>, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a Markdown-rendered table with optional image media and reply buttons. */
     sendInteractiveTable(jid: string, table: { title?: string; headers?: unknown[]; rows?: unknown[][]; image?: unknown; buttons?: Array<{ id?: string; text?: string; buttonText?: string }>; footer?: string }, options?: Record<string, unknown>): Promise<unknown>;
     deleteGroupStatus(jid: string, key: WAMessageKey): Promise<unknown>;

package/lib/index.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/index.js
+ * About: Lib module for the Plogme WhatsApp protocol client.
+ * Important exports: makeWASocket, checkStatusWA
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import makeWASocket, { checkStatusWA } from './Socket/index.js';
 export * from '../WAProto/index.js';
 export * from './Utils/index.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "plogme",
-  "version": "2.1.0",
-  "description": "Production-ready Baileys fork ⚉ with AI groups, Meta AI prompting, safe compositing fallbacks, rich responses, interactive messages, albums, newsletters, and communities — without antiban wrappers.",
+  "version": "2.1.2",
+  "description": "Production-ready Baileys fork ⚉ with AI groups, Meta AI prompting, safe compositing fallbacks, rich responses, interactive messages, albums, newsletters, and communities — with antiban wrappers.",
   "main": "lib/index.js",
   "type": "module",
   "scripts": {
@@ -30,6 +30,13 @@
     "cody ai",
     "bot-planning-replay",
     "plogme",
+    "richHtmlMessages",
+    "group status",
+    "animated wallpapers",
+    "request location",
+    "unified rich response",
+    "rich table preview",
+    "antiban baileys",
     "interactive-messages",
     "js-whatsapp",
     "meta-compositing",