@codexverified/baileys 2.14.14 → 2.17.18

package/lib/index.d.ts

@@ -121,6 +121,83 @@ export interface AIPromptOptions {
     [key: string]: unknown;
 }
 
+export interface SocialEntityContent {
+    username?: string;
+    platform?: string;
+    title?: string;
+    subtitle?: string;
+    imageUrl?: string;
+    entityId?: string | number;
+    entityUrl?: string;
+    entityType?: string;
+    fullName?: string;
+    isVerified?: boolean;
+    resultText?: string;
+    botJid?: string;
+    responseId?: string;
+}
+
+export interface RichMapAnnotation {
+    annotationNumber?: number;
+    latitude: number;
+    longitude: number;
+    title?: string;
+    body?: string;
+}
+
+export interface RichMapContent {
+    centerLatitude: number;
+    centerLongitude: number;
+    latitudeDelta?: number;
+    longitudeDelta?: number;
+    annotations?: RichMapAnnotation[];
+    showInfoList?: boolean;
+    verificationMetadata?: Record<string, unknown>;
+}
+
+export interface BotPromptSuggestionsContent {
+    text?: string;
+    suggestions: string[];
+    selectedPromptIndex?: number;
+    selectedPromptId?: string;
+    verificationMetadata?: Record<string, unknown>;
+}
+
+export interface BotSourceContent {
+    provider?: number;
+    thumbnailCdnUrl?: string;
+    thumbnailUrl?: string;
+    sourceProviderUrl?: string;
+    url?: string;
+    sourceQuery?: string;
+    query?: string;
+    faviconCdnUrl?: string;
+    faviconUrl?: string;
+    citationNumber?: number;
+    sourceTitle?: string;
+    title?: string;
+}
+
+export interface BotSourcesContent {
+    text?: string;
+    sources: BotSourceContent[];
+    verificationMetadata?: Record<string, unknown>;
+}
+
+export interface RichDynamicMediaContent {
+    url: string;
+    type?: 'IMAGE' | 'GIF' | string;
+    version?: number;
+    loopCount?: number;
+    verificationMetadata?: Record<string, unknown>;
+}
+
+export interface BotPttTranscriptContent {
+    transcript: string;
+    text?: string;
+    verificationMetadata?: Record<string, unknown>;
+}
+
 export interface RelayMessageOptions {
     messageId?: string;
     /** Recipient-only delivery: skip the sender’s own devices in a one-to-one chat. */
@@ -162,6 +239,8 @@ export interface WASocket {
     sendMessage(jid: string | string[], content: StatusContent | GroupStatusContent | Record<string, unknown>, options?: Partial<StatusOptions> & Record<string, unknown>): Promise<unknown>;
     /** Relay a prepared message with optional recipient/device-scoping controls. */
     relayMessage(jid: string, message: Record<string, unknown>, options?: RelayMessageOptions): Promise<unknown>;
+    /** Resolve a WhatsApp channel invite code or URL to newsletter metadata. */
+    newsletterGetInviteInfo(inviteCodeOrUrl: string): Promise<Record<string, unknown> | null>;
     deleteGroupStatus(jid: string, key: WAMessageKey): Promise<unknown>;
     /** Reports the contact and blocks it after WhatsApp accepts the report. */
     reportContact(jid: string, messageKeys?: WAMessageKey[]): Promise<unknown>;
@@ -301,17 +380,43 @@ export interface WASocket {
     sendMarkdownQuote(jid: string, content?: { text?: string }, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a quote plus a COPY_TO_CLIPBOARD action. */
     sendQuoteCopy(jid: string, content: { text?: string; copyText: string; copyLabel?: string; alignment?: 'END' | 'START' | 'CENTER' }, options?: Record<string, unknown>): Promise<unknown>;
-    /** Send an experimental album containing at least two image/video items. */
+    /** Send a full-width stacked AIRich album with at least two image/video URL items. */
     sendAlbumMessage(jid: string, medias: Array<Record<string, unknown>>, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a provider-neutral AIRich social/entity result card. */
+    sendSocialEntity(jid: string, content?: SocialEntityContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a protocol-backed AIRich map with optional numbered annotations. */
+    sendRichMap(jid: string, content: RichMapContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send BotSuggestedPromptMetadata with a rich-response text fallback. */
+    sendBotPromptSuggestions(jid: string, content: BotPromptSuggestionsContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send BotSourcesMetadata for citation-aware bot responses. */
+    sendBotSources(jid: string, content: BotSourcesContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send an experimental AIRich dynamic image/GIF submessage. */
+    sendRichDynamicMedia(jid: string, content: RichDynamicMediaContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send BotPttPromptMetadata containing a caller-provided transcript. */
+    sendBotPttTranscript(jid: string, content: BotPttTranscriptContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send the primary Instagram profile result using the universal social/entity format. */
+    sendInstagramProfile(jid: string, content: SocialEntityContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send arbitrary A2UI/interactive payloads with immediate relay/edit rendering. */
+    sendA2UIMessage(jid: string, content?: A2UIMessageContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send the large A2UI command/function menu with an image header and URL buttons. */
+    sendA2UICommandMenu(jid: string, content?: { image?: unknown; title?: string; rows?: Array<[string, string, string?] | { title?: string; description?: string; id?: string }>; buttons?: Array<{ text?: string; label?: string; url?: string }>; fallback?: string }, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send the manually serialized AIRich command card with image, Markdown, widget CTAs, and footer actions. */
+    sendAIRichCommandMenu(jid: string, content: { image: string; title?: string; subtitle?: string; code?: string; rows?: Array<[string, string] | { command?: string; description?: string }>; buttons?: Array<{ id?: string; text?: string; label?: string; url?: string; toast?: string }>; footer?: string; latexImage?: string; latexExpression?: string }, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a GenAI unified-response grid of video primitives. Requires at least two video URLs. */
+    sendVideoGridMessage(jid: string, videos: Array<string | { url?: string; videoUrl?: string; reelsUrl?: string; postId?: string | number; title?: string; thumbnailUrl?: string; thumbnail?: string; creator?: string; avatarUrl?: string; contentHash?: string; likes?: number; comments?: number; shares?: number; isVerified?: boolean; sourceApp?: string; progressiveUrls?: string[]; dashManifests?: string[] }>, options?: Record<string, unknown>): Promise<unknown>;
     /** Send experimental bot diagnostic metadata. */
     sendBotDiagnostics(jid: string, content?: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
     /** Send experimental bot command metadata. */
     sendBotCommand(jid: string, content?: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send an experimental bot planning/execution-plan rich response. */
+    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 experimental resolved tool-call metadata. */
     sendBotToolResult(jid: string, content?: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
     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>;
+    /** Compatibility alias for sendRichButtonGrid. */
+    HoldOn(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. */
@@ -320,6 +425,10 @@ export interface WASocket {
     sendWhatsAppFlow(jid: string, flow: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a complete GenAI-style rich response envelope. */
     sendRichMedia(jid: string, content?: Record<string, unknown>, quoted?: unknown, options?: Record<string, unknown>): Promise<{ message: unknown; messageId: string }>;
+    /** Send one tolerant rich response containing every supported section supplied in content. */
+    sendCodexMessage(jid: string, content?: Record<string, unknown>, quoted?: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    /** Search package source files for a literal or regular-expression pattern. */
+    grepCode(pattern: string, options?: { regex?: boolean; flags?: string; caseSensitive?: boolean; dirs?: string[]; includeReadme?: boolean; maxResults?: number }): Array<{ file: string; line: number; column: number; text: string }>;
     /** Send a native AI image/video generation card. */
     sendRichGeneration(jid: string, content?: RichGenerationContent, quoted?: unknown, options?: Record<string, unknown>): Promise<RichGenerationResult>;
     /** Edit an existing rich generation card in place. */
@@ -351,6 +460,8 @@ export interface WASocket {
     sendHtmlMessage(jid: string, content: { html: string; trustedSources?: string[] }, options?: Record<string, unknown>): Promise<unknown>;
     /** Send the built-in HTML slot-machine payload. */
     sendSlotMachine(jid: string, options?: { title?: string; startingCredits?: number }, sendOptions?: Record<string, unknown>): Promise<unknown>;
+    /** Send the built-in interactive Codex mini-app. */
+    sendMiniApp(jid: string, options?: { title?: string; [key: string]: unknown }, sendOptions?: Record<string, unknown>): Promise<unknown>;
     /** Send a fetched website preview as an HTML rich response. */
     sendWebsitePreview(jid: string, url: string, options?: Record<string, unknown>, sendOptions?: Record<string, unknown>): Promise<unknown>;
     /** Send a lightweight HTML link-preview card. */
@@ -386,6 +497,7 @@ export declare function makeCacheManagerAuthState(store: CacheManagerStore, sess
 }>;
 
 /** Generate a self-contained local slot-machine HTML payload. */
+export declare function generateMiniAppHtml(options?: { title?: string; [key: string]: unknown }): string;
 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;
@@ -423,3 +535,14 @@ declare function makeWASocket(config: SocketConfig): WASocket;
 export { makeWASocket };
 export default makeWASocket;
     
+
+export declare const BotCapabilityType: Record<string, number>;
+export declare function normalizeBotCapabilities(capabilities?: unknown[]): number[];
+export declare function buildBotCapabilityMetadata(capabilities?: unknown[]): Record<string, unknown>;
+export declare function buildBotRichResponse(options?: Record<string, unknown>): Record<string, unknown>;
+
+export declare function prepareVerticalAlbumMessage(options?: { items?: Array<Record<string, unknown>>; verificationMetadata?: Record<string, unknown> }): Record<string, unknown>;
+export declare function prepareAIRichCommandMenu(options?: { image?: string; title?: string; subtitle?: string; code?: string; rows?: Array<[string, string] | Record<string, unknown>>; buttons?: Array<Record<string, unknown>>; footer?: string; latexImage?: string; latexExpression?: string }): Record<string, unknown>;
+export declare function prepareVideoGridMessage(options?: { videos?: Array<string | Record<string, unknown>>; verificationMetadata?: Record<string, unknown> }): Record<string, unknown>;
+
+                                                            

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@codexverified/baileys",
-   "version": "2.14.14",
+   "version": "2.17.18",
    "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",