ruby-baileys 0.0.0-stage → 1.5.17

package/src/Defaults/index.js

@@ -0,0 +1,165 @@
+/* Elaina Baileys maintained distribution. Upstream notices and license are preserved in LICENSE and NOTICE.md. */
+import { proto } from '../../WAProto/index.js';
+import { makeLibSignalRepository } from '../Signal/libsignal.js';
+import { Browsers } from '../Utils/browser-utils.js';
+import logger from '../Utils/logger.js';
+const version = [2, 3000, 1049236237];
+export const UNAUTHORIZED_CODES = [401, 403, 419];
+export const BIZ_BOT_SUPPORT_PAYLOAD = '{"version":1,"is_ai_message":true,"should_upload_client_logs":false,"should_show_system_message":false,"ticket_id":"7004947587700716","citation_items":[],"ticket_locale":"us"}';
+export const DEFAULT_ORIGIN = 'https://web.whatsapp.com';
+export const CALL_VIDEO_PREFIX = 'https://call.whatsapp.com/video/';
+export const CALL_AUDIO_PREFIX = 'https://call.whatsapp.com/voice/';
+export const DONATE_URL = 'https://www.npmjs.com/package/@rexxhayanasi/elaina-baileys';
+export const LIBRARY_NAME = 'rexxhayanasi/elaina-baileys';
+export const DEF_CALLBACK_PREFIX = 'CB:';
+export const DEF_TAG_PREFIX = 'TAG:';
+export const PHONE_CONNECTION_CB = 'CB:Pong';
+export const WA_ADV_ACCOUNT_SIG_PREFIX = Buffer.from([6, 0]);
+export const WA_ADV_DEVICE_SIG_PREFIX = Buffer.from([6, 1]);
+export const WA_ADV_HOSTED_ACCOUNT_SIG_PREFIX = Buffer.from([6, 5]);
+export const WA_ADV_HOSTED_DEVICE_SIG_PREFIX = Buffer.from([6, 6]);
+export const WA_DEFAULT_EPHEMERAL = 7 * 24 * 60 * 60;
+
+export const STATUS_EXPIRY_SECONDS = 24 * 60 * 60;
+
+export const PLACEHOLDER_MAX_AGE_SECONDS = 14 * 24 * 60 * 60;
+export const NOISE_MODE = 'Noise_XX_25519_AESGCM_SHA256\0\0\0\0';
+export const DICT_VERSION = 3;
+export const KEY_BUNDLE_TYPE = Buffer.from([5]);
+export const NOISE_WA_HEADER = Buffer.from([87, 65, 6, DICT_VERSION]);
+
+export const URL_REGEX = /https:\/\/(?![^:@\/\s]+:[^:@\/\s]+@)[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}(:\d+)?(\/[^\s]*)?/g;
+export const WA_CERT_DETAILS = {
+    SERIAL: 0,
+    ISSUER: 'WhatsAppLongTerm1',
+    PUBLIC_KEY: Buffer.from('142375574d0a587166aae71ebe516437c4a28b73e3695c6ce1f7f9545da8ee6b', 'hex')
+};
+export const PROCESSABLE_HISTORY_TYPES = [
+    proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP,
+    proto.HistorySync.HistorySyncType.PUSH_NAME,
+    proto.HistorySync.HistorySyncType.RECENT,
+    proto.HistorySync.HistorySyncType.FULL,
+    proto.HistorySync.HistorySyncType.ON_DEMAND,
+    proto.HistorySync.HistorySyncType.NON_BLOCKING_DATA,
+    proto.HistorySync.HistorySyncType.INITIAL_STATUS_V3
+];
+export const DEFAULT_CACHE_TTLS = {
+    SIGNAL_STORE: 5 * 60,
+    MSG_RETRY: 60 * 60,
+    CALL_OFFER: 5 * 60,
+    USER_DEVICES: 5 * 60,
+    OUTBOUND_RESEND: 60
+};
+
+export const MAX_OUTBOUND_RESEND_ENTRIES = 512;
+export const MEMBER_LABEL_MAX_LENGTH = 30;
+export const DEFAULT_CACHE_MAX_KEYS = 20000;
+
+export const PAIRING_RESPONSE_GRACE_MS = 30000;
+export const DEFAULT_CONNECTION_CONFIG = {
+    version: version,
+    browser: Browsers.macOS('Chrome'),
+    waWebSocketUrl: 'wss://web.whatsapp.com/ws/chat',
+    connectTimeoutMs: 20000,
+    keepAliveIntervalMs: 15000,
+    logger: logger.child({ class: 'elaina' }),
+    emitOwnEvents: true,
+    AnchorGuard: false,
+    AnchorGuardConfig: {},
+    defaultQueryTimeoutMs: 60000,
+    customUploadHosts: [],
+    retryRequestDelayMs: 250,
+    maxMsgRetryCount: 3,
+    maxEventListeners: 64,
+    ackRetryDelayMs: 750,
+    maxAckRetryCount: 3,
+    maxRetryQueueSize: 64,
+    pairingCodeTimeoutMs: 180000,
+    fireInitQueries: true,
+    auth: undefined,
+    markOnlineOnConnect: true,
+    syncFullHistory: true,
+    patchMessageBeforeSending: msg => msg,
+    shouldSyncHistoryMessage: ({ syncType }) => {
+        return syncType !== proto.HistorySync.HistorySyncType.FULL;
+    },
+    shouldIgnoreJid: () => false,
+    linkPreviewImageThumbnailWidth: 192,
+    transactionOpts: { maxCommitRetries: 10, delayBetweenTriesMs: 3000 },
+    generateHighQualityLinkPreview: true,
+    enableAutoSessionRecreation: true,
+    enableRecentMessageCache: true,
+    options: {},
+    appStateMacVerification: {
+        patch: false,
+        snapshot: false
+    },
+    countryCode: 'US',
+    getMessage: async () => undefined,
+    cachedGroupMetadata: async () => undefined,
+    makeSignalRepository: makeLibSignalRepository
+};
+export const MEDIA_PATH_MAP = {
+    image: '/mms/image',
+    video: '/mms/video',
+    document: '/mms/document',
+    audio: '/mms/audio',
+    sticker: '/mms/image',
+    'sticker-pack': '/mms/sticker-pack',
+    'thumbnail-sticker-pack': '/mms/thumbnail-sticker-pack',
+    'thumbnail-link': '/mms/image',
+    'thumbnail-image': '/mms/image',
+    'thumbnail-video': '/mms/video',
+    'thumbnail-document': '/mms/document',
+    'product-catalog-image': '/product/image',
+    'md-app-state': '',
+    'md-msg-hist': '/mms/md-app-state',
+    'biz-cover-photo': '/pps/biz-cover-photo'
+};
+
+export const NEWSLETTER_MEDIA_PATH_MAP = {
+    image: '/newsletter/newsletter-image',
+    video: '/newsletter/newsletter-video',
+    document: '/newsletter/newsletter-document',
+    audio: '/newsletter/newsletter-audio',
+    sticker: '/newsletter/newsletter-image',
+    'thumbnail-link': '/newsletter/newsletter-thumbnail-link'
+};
+export const MEDIA_HKDF_KEY_MAPPING = {
+    audio: 'Audio',
+    document: 'Document',
+    gif: 'Video',
+    image: 'Image',
+    ppic: '',
+    product: 'Image',
+    ptt: 'Audio',
+    'sticker-pack': 'Sticker Pack',
+    'thumbnail-sticker-pack': 'Sticker Pack Thumbnail',
+    sticker: 'Image',
+    video: 'Video',
+    'thumbnail-document': 'Document Thumbnail',
+    'thumbnail-image': 'Image Thumbnail',
+    'thumbnail-video': 'Video Thumbnail',
+    'thumbnail-link': 'Link Thumbnail',
+    'md-msg-hist': 'History',
+    'md-app-state': 'App State',
+    'product-catalog-image': 'Product Catalog Image',
+    'payment-bg-image': 'Payment Background',
+    ptv: 'Video',
+    'biz-cover-photo': 'Image',
+    location: 'Location',
+    contact: 'Contact',
+    'voip-token': 'Voip Token'
+};
+export const MEDIA_KEYS = Object.keys(MEDIA_PATH_MAP);
+
+export const HISTORY_SYNC_PAUSED_TIMEOUT_MS = 120000;
+export const MIN_PREKEY_COUNT = 5;
+export const INITIAL_PREKEY_COUNT = 812;
+export const UPLOAD_TIMEOUT = 30000;
+export const TimeMs = {
+    Minute: 60 * 1000,
+    Hour: 60 * 60 * 1000,
+    Day: 24 * 60 * 60 * 1000,
+    Week: 7 * 24 * 60 * 60 * 1000
+};

package/src/MessageBuilder/bot-signature.d.ts

@@ -0,0 +1,22 @@
+export declare const BOT_SIGNATURE_VERSION: '1';
+export declare const BOT_SIGNATURE_USE_CASE_WA_BOT_MSG: 1;
+export declare const BOT_SIGNATURE_ROOT_VERSION: string;
+export declare const BOT_SIGNATURE_ROOT_CERTIFICATE: string;
+
+export declare function loadBotSignatureRoot(): import('crypto').X509Certificate;
+
+export declare function constructSignaturePayload(options: {
+    botFbid: string;
+    messageDigest: Buffer | Uint8Array;
+    version?: string;
+}): Buffer;
+
+export declare function verifyBotSignature(options: {
+    botJid?: string;
+    unifiedResponseBytes?: Buffer | Uint8Array;
+    proof?: any;
+    at?: number;
+    root?: import('crypto').X509Certificate;
+}): { status: 'passed' | 'failed'; reason?: string };
+
+export declare function isParsableCertificateChain(chain?: unknown): boolean;

package/src/MessageBuilder/bot-signature.js

@@ -0,0 +1,123 @@
+/* Elaina Baileys maintained distribution. Upstream notices and license are preserved in LICENSE and NOTICE.md. */
+import { X509Certificate, verify as cryptoVerify } from 'crypto'
+
+export const BOT_SIGNATURE_VERSION = '1'
+export const BOT_SIGNATURE_USE_CASE_WA_BOT_MSG = 1
+export const BOT_SIGNATURE_ROOT_VERSION = '2025-10'
+
+export const BOT_SIGNATURE_ROOT_CERTIFICATE = `-----BEGIN CERTIFICATE-----
+MIIC7TCCApOgAwIBAgIUAtu5QuxmVhfGT8LPkjfm40mSl0AwCgYIKoZIzj0EAwIw
+dzEgMB4GA1UEAwwXTWV0YSBXQSBGZWF0dXJlIFJvb3QgQ0ExCzAJBgNVBAYTAlVT
+MRMwEQYDVQQIDApDYWxpZm9ybmlhMRMwEQYDVQQHDApNZW5sbyBQYXJrMRwwGgYD
+VQQKDBNNZXRhIFBsYXRmb3JtcyBJbmMuMCAXDTI1MDkwNDE3MzEyNFoYDzIwNjUw
+OTA0MTczMTI0WjB3MSAwHgYDVQQDDBdNZXRhIFdBIEZlYXR1cmUgUm9vdCBDQTEL
+MAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWExEzARBgNVBAcMCk1lbmxv
+IFBhcmsxHDAaBgNVBAoME01ldGEgUGxhdGZvcm1zIEluYy4wWTATBgcqhkjOPQIB
+BggqhkjOPQMBBwNCAAT60blw90ebreMkw8+Wpcs0ETAkr1VQjoZoyi7PSSQbsoiP
+qYRnzfRrR+xiahaXbYU83qXiTHjVUiOU9wDxI83qo4H6MIH3MA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFNO7KMTVSYUxkL6VS3LyWJw7m76zMIG0BgNVHSMEgaww
+gamAFNO7KMTVSYUxkL6VS3LyWJw7m76zoXukeTB3MSAwHgYDVQQDDBdNZXRhIFdB
+IEZlYXR1cmUgUm9vdCBDQTELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3Ju
+aWExEzARBgNVBAcMCk1lbmxvIFBhcmsxHDAaBgNVBAoME01ldGEgUGxhdGZvcm1z
+IEluYy6CFALbuULsZlYXxk/Cz5I35uNJkpdAMA4GA1UdDwEB/wQEAwIBhjAKBggq
+hkjOPQQDAgNIADBFAiAINhjk9DbP416vx/WjqdUfexgic08aQsxnpDDsNE5M0gIh
+ANorq7KwCQVMtS2or5uKJAQsx1FxCHyDafq2GCk9t0AN
+-----END CERTIFICATE-----`
+
+let rootCertificate = null
+
+export const loadBotSignatureRoot = () => {
+    if (!rootCertificate) {
+        rootCertificate = new X509Certificate(BOT_SIGNATURE_ROOT_CERTIFICATE)
+    }
+    return rootCertificate
+}
+
+export const constructSignaturePayload = ({ botFbid, messageDigest, version = BOT_SIGNATURE_VERSION }) =>
+    Buffer.concat([Buffer.from(version, 'utf8'), Buffer.from(String(botFbid), 'utf8'), Buffer.from(messageDigest)])
+
+export const isParsableCertificateChain = (chain) => {
+    if (!Array.isArray(chain) || !chain.length) {
+        return false
+    }
+    try {
+        for (const entry of chain) {
+            new X509Certificate(Buffer.from(entry))
+        }
+        return true
+    }
+    catch {
+        return false
+    }
+}
+
+const failed = reason => ({ status: 'failed', reason })
+
+const validAt = (certificate, at) => {
+    const from = Date.parse(certificate.validFrom)
+    const to = Date.parse(certificate.validTo)
+    return Number.isFinite(from) && Number.isFinite(to) && at >= from && at <= to
+}
+
+export const verifyBotSignature = ({ botJid, unifiedResponseBytes, proof, at = Date.now(), root = loadBotSignatureRoot() } = {}) => {
+    if (!proof) {
+        return failed('no WA_BOT_MSG proof')
+    }
+    if (Number(proof.version) !== 1) {
+        return failed(`unsupported signature version ${proof.version}`)
+    }
+    if (!proof.signature?.length) {
+        return failed('proof carries no signature')
+    }
+    if (!proof.certificateChain?.length) {
+        return failed('empty certificate chain')
+    }
+    if (!unifiedResponseBytes?.length) {
+        return failed('no unified response bytes to verify')
+    }
+    const botFbid = String(botJid ?? '').split('@')[0]
+    if (!botFbid) {
+        return failed('no bot jid, the fbid is part of the signed payload')
+    }
+
+    let chain
+    try {
+        chain = proof.certificateChain.map(entry => new X509Certificate(Buffer.from(entry)))
+    }
+    catch (error) {
+        return failed(`certificate did not parse: ${error.message}`)
+    }
+
+    const [leaf] = chain
+    if (!validAt(leaf, at)) {
+        return failed('leaf certificate is outside its validity window')
+    }
+
+    const full = [...chain, root]
+    for (let index = 0; index < full.length - 1; index += 1) {
+        const issuer = full[index + 1]
+        if (!validAt(issuer, at)) {
+            return failed(`issuer at position ${index + 1} is outside its validity window`)
+        }
+        let ok = false
+        try {
+            ok = full[index].verify(issuer.publicKey)
+        }
+        catch (error) {
+            return failed(`chain verification threw at position ${index}: ${error.message}`)
+        }
+        if (!ok) {
+            return failed(`chain broken at position ${index}`)
+        }
+    }
+
+    const payload = constructSignaturePayload({ botFbid, messageDigest: unifiedResponseBytes })
+    let ok = false
+    try {
+        ok = cryptoVerify(null, payload, leaf.publicKey, Buffer.from(proof.signature))
+    }
+    catch (error) {
+        return failed(`signature verification threw: ${error.message}`)
+    }
+    return ok ? { status: 'passed' } : failed('signature does not match the unified response bytes')
+}

package/src/MessageBuilder/extras.d.ts

@@ -0,0 +1,396 @@
+export declare const AI_RICH_LAYOUTS: readonly string[];
+export declare const AI_RICH_PRIMITIVES: readonly string[];
+export declare const AI_RICH_INLINE_ENTITIES: readonly string[];
+export declare const AI_RICH_ITEMS: readonly string[];
+export declare const AI_RICH_PRIMITIVES_WEB_RENDERED: readonly string[];
+export declare const AI_RICH_PRIMITIVE_INTERFACE: 'GenAIUXPrimitive';
+export declare const AI_RICH_PRIMITIVES_WITHOUT_SCHEMA: readonly string[];
+export declare const AI_RICH_HTML_PRIMITIVE: 'GenAIaeacdsnwHtmlPrimitive';
+
+export declare const DividerType: Readonly<{ DOT: 'DOT'; HORIZONTAL_LINE: 'HORIZONTAL_LINE' }>;
+export declare const ImagineType: Readonly<{ IMAGINE: 'IMAGINE'; ANIMATE: 'ANIMATE'; MEMU: 'MEMU' }>;
+export declare const ImagineStatus: Readonly<{ GENERATING: 'GENERATING'; READY: 'READY'; FAILED: 'FAILED' }>;
+export declare const ThinkingIcon: Readonly<{ THINKING: 'THINKING'; WEB_SEARCH: 'WEB_SEARCH'; META_SEARCH: 'META_SEARCH' }>;
+export declare const TaskStatus: Readonly<{ PENDING: 'PENDING'; RUNNING: 'RUNNING'; DONE: 'DONE' }>;
+export declare const FooterActionType: Readonly<Record<string, string>>;
+export declare const AddonActionType: Readonly<Record<string, string>>;
+
+export declare function dividerSection(options?: { dividerType?: string }): any;
+export declare function spacerSection(options?: { spacing?: number }): any;
+export declare function imageSection(url: string, options?: {
+    fallbackUrl?: string;
+    previewUrl?: string;
+    previewFallbackUrl?: string;
+}): any;
+export declare function taskSection(options: {
+    taskId: string | number;
+    title?: string;
+    subtitle?: string;
+    status?: string;
+}): any;
+export declare function latexSection(expression: string, options?: {
+    image?: string;
+    width?: number;
+    height?: number;
+    fontHeight?: number;
+    padding?: number;
+}): any;
+export declare function thinkingSection(title: string, options?: {
+    icon?: string;
+    inProgress?: boolean;
+    metaSearchApps?: string[];
+    thoughtDurationSec?: number;
+}): any;
+export declare function progressSection(title: string, options?: {
+    icon?: string;
+    inProgress?: boolean;
+    metaSearchApps?: string[];
+    thoughtDurationSec?: number;
+}): any;
+
+export declare function lockHeight(height: number): string;
+
+export declare const HTML_APP_BRIDGE: 'AndroidBridge';
+
+export declare function dataUri(bytes: Buffer | Uint8Array, mimetype: string): string;
+
+export declare function htmlMedia(bytes: Buffer | Uint8Array, options: {
+    mimetype: string;
+    tag?: 'video' | 'audio' | 'img';
+    label?: string;
+    poster?: string;
+    id?: string;
+    attributes?: string;
+}): string;
+
+export interface AutoHeightOptions {
+    min?: number;
+    max?: number;
+    settleMs?: number;
+    maxReports?: number;
+}
+
+export declare function autoHeight(options?: AutoHeightOptions): string;
+
+export interface ScrollControlsOptions {
+    /** CSS selector for the pane to scroll. Defaults to the #__wrap that height creates. */
+    target?: string;
+    /** Pixels per tap, and per repeat while held. */
+    step?: number;
+    /** Repeat interval while a button is held down, at least 16. */
+    holdMs?: number;
+    /** Button edge length in pixels, at least 24. */
+    size?: number;
+    side?: 'right' | 'left';
+    inset?: number;
+}
+
+/**
+ * On-screen scroll buttons. Touch scrolling inside the bubble is taken by the
+ * chat list behind it, so a page taller than its bubble cannot be scrolled by
+ * dragging; these move the pane programmatically instead. Hidden when the
+ * content already fits.
+ */
+export declare function scrollControls(options?: ScrollControlsOptions): string;
+
+export declare const AI_RICH_HTML_PRIMITIVE_CLASS: 'FOAHtmlPrimitive';
+
+export declare function htmlSection(html: string, options?: {
+    trustedSources?: string[];
+    height?: number;
+    typename?: string;
+}): any;
+
+export declare function sendHtmlApp(sock: any, jid: string, html: string, options?: {
+    title?: string;
+    label?: string;
+    trustedSources?: string[];
+    height?: number;
+    autoHeight?: boolean | AutoHeightOptions;
+    scrollButtons?: boolean | ScrollControlsOptions;
+    typename?: string;
+    id?: string;
+    bypassDownload?: boolean;
+    guard?: boolean | 'warn';
+    [key: string]: any;
+}): Promise<any>;
+
+export declare const HTML_MIME_TYPE: 'text/html';
+
+export declare function sendHtmlDocument(sock: any, jid: string, html: string, options?: {
+    fileName?: string;
+    caption?: string;
+    [key: string]: any;
+}): Promise<any>;
+
+export interface FileSectionOptions {
+    title?: string;
+    fileExtension?: string;
+    fileLength?: number;
+    pageCount?: number;
+    previewImage?: any;
+}
+
+export declare function fileSection(url: string, options?: FileSectionOptions): any;
+export declare function fileLinkSection(url: string, options?: FileSectionOptions): any;
+
+export interface BotMediaMetadata {
+    fileSha256?: string;
+    mediaKey?: string;
+    fileEncSha256?: string;
+    directPath?: string;
+    mediaKeyTimestamp?: number;
+    mimetype?: string;
+}
+
+export declare function botMediaMetadata(documentMessage: any): BotMediaMetadata;
+
+export declare function prepareFileArtifact(sock: any, content: string | Uint8Array, options?: {
+    mimetype?: string;
+    fileName?: string;
+    title?: string;
+    id?: string;
+}): Promise<{
+    mediaId: string;
+    media: BotMediaMetadata;
+    documentMessage: any;
+    section: any;
+    mediaDetails: { id: string; previewMedia: BotMediaMetadata; highResMedia: BotMediaMetadata };
+}>;
+
+export declare function sendHtmlArtifact(sock: any, jid: string, html: string, options?: {
+    fileName?: string;
+    title?: string;
+    label?: string;
+    id?: string;
+    bypassDownload?: boolean;
+    [key: string]: any;
+}): Promise<{ message: any; mediaId: string }>;
+
+export declare const SourceProvider: Readonly<{ UNKNOWN: 0; BING: 1; GOOGLE: 2; SUPPORT: 3; OTHER: 4 }>;
+
+export interface SourceInput {
+    url: string;
+    title?: string;
+    query?: string;
+    favicon?: string;
+    thumbnail?: string;
+    citation?: number;
+    provider?: number;
+}
+
+export declare function botSourcesMetadata(sources: SourceInput[]): { sources: any[] };
+
+export declare const EMBEDDED_SCREEN_PRESENTATION: Readonly<{ HALF_HEIGHT: 'HALF_HEIGHT'; FULL_HEIGHT: 'FULL_HEIGHT' }>;
+
+export declare const EMBEDDED_SCREEN_TYPENAME: string;
+export declare const EMBEDDED_SCREEN_TABBED_TYPENAME: string;
+export declare const EMBEDDED_SCREEN_TAB_TYPENAME: string;
+export declare const AI_RICH_SECTION_TYPENAME: string;
+export declare const AI_RICH_UNIFIED_RESPONSE_TYPENAME: string;
+export declare const AI_RICH_UNIFIED_RESPONSE_TYPENAME_APP: string;
+export declare const AI_RICH_NESTED_UNIFIED_RESPONSE_TYPENAME: string;
+export declare const EMBEDDED_SCREEN_SINGLE_TYPENAME: string;
+export declare const EMBEDDED_SCREEN_CONTEXTUAL_TYPENAME: string;
+export declare const AI_RICH_NODES: readonly string[];
+export declare function collectTypenames(root: any, options?: { limit?: number }): string[];
+
+export declare function embeddedTab(options?: {
+    id?: string;
+    header?: any;
+    tabHeader?: any;
+    sections?: any[];
+    typename?: string;
+}): any;
+
+export declare function embeddedTabbedContent(tabs: any[], options?: { typename?: string }): any;
+
+export declare const AI_RICH_RESPONSE_KEYS: readonly string[];
+
+export declare function embeddedScreen(options?: {
+    id?: string;
+    title?: string;
+    content?: any[];
+    tabs?: any[];
+    tabsTypename?: string;
+    typename?: string;
+    header?: any;
+    body?: any;
+    artifacts?: any[];
+    steps?: any[];
+    stepEntries?: any[];
+    sources?: any[];
+    pollId?: string;
+}): any;
+
+export declare function readEmbeddedTabs(screen: any): any[];
+
+export declare function readEmbeddedSections(screen: any): any[];
+
+export declare function footerActionSection(actionType: string, options?: {
+    buttonText?: string;
+    url?: string;
+}): any;
+
+export declare const A2UI_VERSION: 'v0.9';
+export declare const A2UI_BASIC_CATALOG: string;
+export declare const A2UI_ROOT_ID: 'root';
+
+export interface A2UIComponent {
+    id: string;
+    component: string;
+    [key: string]: any;
+}
+
+export interface A2UIElement {
+    type: 'info_card' | 'list_card';
+    [key: string]: any;
+}
+
+export declare function a2uiText(id: string, text: string, options?: { variant?: string }): A2UIComponent;
+export declare function a2uiImage(id: string, url: string, options?: { variant?: string; fit?: string }): A2UIComponent;
+export declare function a2uiColumn(id: string, children?: string[]): A2UIComponent;
+export declare function a2uiRow(id: string, children?: string[]): A2UIComponent;
+export declare function a2uiCard(id: string, child: string): A2UIComponent;
+export declare function a2uiInfoCard(element?: Record<string, any>): A2UIElement;
+export declare function a2uiListCard(element?: Record<string, any>): A2UIElement;
+export declare function a2uiFallback(components: any[]): string;
+
+export declare function a2uiSurface(components: A2UIComponent[], options?: {
+    surfaceId?: string;
+    root?: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    version?: string;
+    type?: string;
+    title?: string;
+}): any;
+
+export declare function a2uiWidget(components: A2UIComponent[], options?: {
+    uuid?: string;
+    surfaceId?: string;
+    root?: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    version?: string;
+    type?: string;
+    title?: string;
+    fallback?: string;
+    data?: any;
+}): BloksWidget;
+
+export declare function sendA2UI(sock: any, jid: string, components: A2UIComponent[], options?: {
+    buttons?: any[];
+    contextInfo?: any;
+    uuid?: string;
+    surfaceId?: string;
+    root?: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    type?: string;
+    title?: string;
+    fallback?: string;
+    messageId?: string;
+    additionalNodes?: any[];
+    [key: string]: any;
+}): Promise<any>;
+
+export declare function buildA2UISection(components: A2UIComponent[], options?: {
+    uuid?: string;
+    surfaceId?: string;
+    root?: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    version?: string;
+    type?: string;
+    title?: string;
+    data?: any;
+    initialResponse?: string;
+    versioningId?: string;
+}): any;
+
+export declare function sendA2UIBloks(sock: any, jid: string, components: A2UIComponent[], options?: {
+    uuid?: string;
+    surfaceId?: string;
+    root?: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    version?: string;
+    type?: string;
+    title?: string;
+    data?: any;
+    initialResponse?: string;
+    versioningId?: string;
+    [key: string]: any;
+}): Promise<any>;
+
+export declare const BLOKS_A2UI_TYPE: 'im_a2ui';
+export declare const BLOKS_A2UI_REPLY_ACTION: 'a2ui_reply_action';
+export declare const BLOKS_A2UI_SUPPORTED_ELEMENTS: readonly string[];
+
+export interface BloksWidget {
+    type: string;
+    data: string;
+    uuid: string;
+    fallback: string;
+}
+
+export declare function bloksSection(type: string, data?: string | Record<string, any>, options?: {
+    uuid?: string;
+    initialResponse?: string;
+    versioningId?: string;
+}): any;
+
+export declare function bloksWidget(options: {
+    type: string;
+    data?: string | Record<string, any>;
+    uuid?: string;
+    fallback?: string;
+}): BloksWidget;
+
+export declare function sendBloksWidget(sock: any, jid: string, options: {
+    type: string;
+    data?: string | Record<string, any>;
+    uuid?: string;
+    fallback?: string;
+    body?: string;
+    contextInfo?: any;
+    messageId?: string;
+    additionalNodes?: any[];
+    [key: string]: any;
+}): Promise<any>;
+
+export declare function decodeBloksWidget(msg: any): (BloksWidget & { params: any }) | null;
+
+export interface RichMessageRead {
+    kind: 'airich' | 'a2ui' | 'bloks' | 'interactive';
+    text: string;
+    title: string;
+    buttons: { name: string; params: any }[];
+    html: string[];
+    typenames: string[];
+    sections: any[];
+    footerSections: any[];
+    embeddedScreens: any[];
+    embeddedTabs: any[];
+    submessages: any[];
+    responseId?: string;
+    a2ui?: { surfaceId: string; root?: string; catalogId?: string; version: string; components: A2UIComponent[] };
+    bloks?: { type: string; uuid: string; fallback: string; params: any };
+}
+
+export declare function readRichMessage(msg: any): RichMessageRead | null;
+
+export declare function decodeAIRich(msg: any): {
+    responseId?: string;
+    layouts: string[];
+    typenames: string[];
+    footerTypenames: string[];
+    sections: any[];
+    footerSections: any[];
+    embeddedScreens: any[];
+    embeddedTabs: any[];
+    embeddedSections: any[];
+    submessages: any[];
+    unified: any;
+} | null;