Skip to content

The agent that grows with you

21.2 KB
Raw Blame
/**
 * Unit tests for WhatsApp-native bridge payload helpers.
 *
 * These tests avoid importing bridge.js because that file starts an HTTP
 * server and Baileys socket at module load. Keep the helper module pure.
 */

import { strict as assert } from 'node:assert';
import { createHash } from 'node:crypto';
import { mkdtempSync } from 'node:fs';
import { tmpdir } from 'node:os';
import path from 'node:path';
import { getAggregateVotesInPollMessage } from '@whiskeysockets/baileys';

import {
  addMentions,
  buildPollPayload,
  buildTextSendPayload,
  createBoundedMessageStore,
  extractBridgeEvent,
  inboundReadReceiptKeys,
  mediaPayloadForFile,
  pollCreationMessageFromPayload,
  pollUpdateForAggregation,
} from './bridge_helpers.js';

// -- inbound read receipts ------------------------------------------------
{
  const groupKey = {
    id: 'incoming-group-1',
    remoteJid: '[email protected]',
    participant: '[email protected]',
    fromMe: false,
  };

  assert.deepEqual(inboundReadReceiptKeys({ key: groupKey, enabled: false }), []);
  assert.deepEqual(
    inboundReadReceiptKeys({ key: { ...groupKey, fromMe: true }, enabled: true }),
    [],
  );
  const receiptKeys = inboundReadReceiptKeys({ key: groupKey, enabled: true });
  assert.equal(receiptKeys.length, 1);
  assert.equal(receiptKeys[0], groupKey);
  assert.equal(receiptKeys[0].participant, groupKey.participant);
  console.log('  ✓ inbound read receipts preserve the original group message key');
}

// -- quoted outbound text -------------------------------------------------
{
  const store = createBoundedMessageStore(2);
  store.remember({
    key: {
      id: 'inbound-1',
      remoteJid: '[email protected]',
      participant: '[email protected]',
      fromMe: false,
    },
    message: { conversation: 'original text' },
  });

  const { content, options } = buildTextSendPayload('reply text', {
    chatId: '[email protected]',
    replyTo: 'inbound-1',
    messageStore: store,
  });

  assert.deepEqual(content, { text: 'reply text' });
  assert.equal(options.quoted.key.id, 'inbound-1');
  assert.equal(options.quoted.message.conversation, 'original text');
  console.log('  ✓ text replies include Baileys quoted message when resolvable');
}

{
  const store = createBoundedMessageStore(2);
  const { content, options } = buildTextSendPayload('plain text', {
    chatId: '[email protected]',
    replyTo: 'missing-id',
    messageStore: store,
  });

  assert.deepEqual(content, { text: 'plain text' });
  assert.deepEqual(options, {});
  console.log('  ✓ unresolved replyTo falls back to plain text');
}

{
  const mentions = ['[email protected]'];
  const { content } = buildTextSendPayload('hello @15550001111', { mentions });
  const media = addMentions({ image: Buffer.from('png'), caption: 'hello @15550001111' }, mentions);

  assert.deepEqual(content.mentions, mentions);
  assert.deepEqual(media.mentions, mentions);
  console.log('  ✓ outbound text and media payloads preserve native mention JIDs');
}

// -- inbound quote/media/native metadata --------------------------------
{
  const event = await extractBridgeEvent({
    msg: {
      key: {
        id: 'incoming-1',
        remoteJid: '[email protected]',
        participant: '[email protected]',
        fromMe: false,
      },
      pushName: 'Tester',
      messageTimestamp: 123,
      message: {
        extendedTextMessage: {
          text: 'approved',
          contextInfo: {
            stanzaId: 'outbound-1',
            participant: '[email protected]',
            remoteJid: '[email protected]',
            quotedMessage: { conversation: 'approve deploy?' },
          },
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
    botIds: ['[email protected]'],
    downloadMedia: async () => Buffer.from(''),
  });

  assert.equal(event.quotedMessageId, 'outbound-1');
  assert.equal(event.quotedParticipant, '[email protected]');
  assert.equal(event.quotedRemoteJid, '[email protected]');
  assert.equal(event.quotedText, 'approve deploy?');
  assert.deepEqual(event.readReceiptKey, {
    id: 'incoming-1',
    remoteJid: '[email protected]',
    participant: '[email protected]',
    fromMe: false,
  });
  assert.equal(event.hasQuotedMessage, true);
  assert.equal(event.body, 'approved');
  console.log('  ✓ inbound quoted metadata includes quoted text');
}

// -- reply to uncaptioned quoted media resolves the cached original file --
{
  // contextInfo.quotedMessage only ever carries a thumbnail-sized stub for
  // media (or nothing for an uncaptioned attachment) — extractBridgeEvent
  // must fall back to lookupQuotedMedia to find the original cached file.
  const event = await extractBridgeEvent({
    msg: {
      key: {
        id: 'incoming-2',
        remoteJid: '[email protected]',
        participant: '[email protected]',
        fromMe: false,
      },
      pushName: 'Tester',
      messageTimestamp: 123,
      message: {
        extendedTextMessage: {
          text: 'did you save this?',
          contextInfo: {
            stanzaId: 'original-image-1',
            participant: '[email protected]',
            remoteJid: '[email protected]',
            // Real WhatsApp traffic: an uncaptioned quoted image carries no
            // usable text, just a thumbnail-only imageMessage stub.
            quotedMessage: { imageMessage: {} },
          },
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
    botIds: [],
    downloadMedia: async () => Buffer.from(''),
    lookupQuotedMedia: (chatId, messageId) => {
      assert.equal(chatId, '[email protected]');
      assert.equal(messageId, 'original-image-1');
      return { hasMedia: true, mediaType: 'image', mediaUrls: ['/cache/image/img_original.jpg'] };
    },
  });

  assert.deepEqual(event.quotedMediaUrls, ['/cache/image/img_original.jpg']);
  assert.equal(event.quotedMediaType, 'image');
  assert.equal(event.quotedText, 'sent an image');
  console.log('  ✓ reply to uncaptioned quoted image resolves cached original file');
}

// -- bare quote-reply (no own text/media) still resolves quoted media -----
{
  // A reply with no caption of its own (e.g. a bare quote of an uncaptioned
  // image) has empty own body/media, so bridge.js's empty-message guard must
  // consult quotedMediaUrls rather than only event.body/event.hasMedia, or
  // the reply is dropped even though extractBridgeEvent resolved real content.
  const event = await extractBridgeEvent({
    msg: {
      key: {
        id: 'incoming-4',
        remoteJid: '[email protected]',
        participant: '[email protected]',
        fromMe: false,
      },
      pushName: 'Tester',
      messageTimestamp: 123,
      message: {
        extendedTextMessage: {
          text: '',
          contextInfo: {
            stanzaId: 'original-image-2',
            participant: '[email protected]',
            remoteJid: '[email protected]',
            quotedMessage: { imageMessage: {} },
          },
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
    botIds: [],
    downloadMedia: async () => Buffer.from(''),
    lookupQuotedMedia: () => ({ hasMedia: true, mediaType: 'image', mediaUrls: ['/cache/image/img_original.jpg'] }),
  });

  assert.equal(event.body, '');
  assert.equal(event.hasMedia, false);
  assert.deepEqual(event.quotedMediaUrls, ['/cache/image/img_original.jpg']);
  console.log('  ✓ bare quote-reply with no own content still carries resolved quoted media');
}

// -- quoted media lookup miss leaves quoted fields empty (no crash) -------
{
  const event = await extractBridgeEvent({
    msg: {
      key: {
        id: 'incoming-3',
        remoteJid: '[email protected]',
        participant: '[email protected]',
        fromMe: false,
      },
      messageTimestamp: 123,
      message: {
        extendedTextMessage: {
          text: 'thanks',
          contextInfo: {
            stanzaId: 'long-gone-message',
            participant: '[email protected]',
            remoteJid: '[email protected]',
            quotedMessage: { imageMessage: {} },
          },
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
    botIds: [],
    downloadMedia: async () => Buffer.from(''),
    lookupQuotedMedia: () => null,
  });

  assert.deepEqual(event.quotedMediaUrls, []);
  assert.equal(event.quotedMediaType, '');
  console.log('  ✓ quoted media cache miss leaves quoted media fields empty');
}

{
  const event = await extractBridgeEvent({
    msg: {
      key: { id: 'doc-1', remoteJid: '[email protected]', fromMe: false },
      messageTimestamp: 123,
      message: {
        documentMessage: {
          caption: 'see attached',
          fileName: 'report.pdf',
          mimetype: 'application/pdf',
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
    downloadMedia: async () => Buffer.from('pdf'),
    writeMediaFile: async () => '/tmp/report.pdf',
  });

  assert.equal(event.hasMedia, true);
  assert.equal(event.mediaType, 'document');
  assert.equal(event.mime, 'application/pdf');
  assert.equal(event.fileName, 'report.pdf');
  assert.equal(event.nativeType, 'documentMessage');
  assert.deepEqual(event.mediaUrls, ['/tmp/report.pdf']);
  console.log('  ✓ inbound document metadata preserves MIME and filename');
}

{
  const cacheDir = mkdtempSync(path.join(tmpdir(), 'hermes-wa-doc-'));
  const event = await extractBridgeEvent({
    msg: {
      key: { id: 'doc-2', remoteJid: '[email protected]', fromMe: false },
      messageTimestamp: 123,
      message: {
        documentMessage: {
          caption: 'see attached',
          fileName: 'report',
          mimetype: 'application/pdf',
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
    downloadMedia: async () => Buffer.from('pdf'),
    cacheDirs: { document: cacheDir },
  });

  assert.equal(event.mediaUrls.length, 1);
  assert.ok(event.mediaUrls[0].endsWith('_report.pdf'), event.mediaUrls[0]);
  console.log('  ✓ MIME extension is preserved when document filename has none');
}

{
  const event = await extractBridgeEvent({
    msg: {
      key: { id: 'loc-1', remoteJid: '[email protected]', fromMe: false },
      messageTimestamp: 123,
      message: {
        locationMessage: {
          name: 'HQ',
          degreesLatitude: 41.015,
          degreesLongitude: 28.979,
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
  });

  assert.equal(event.mediaType, 'location');
  assert.equal(event.body, '[Location: HQ 41.015,28.979]');
  assert.deepEqual(event.nativeMetadata.location, {
    name: 'HQ',
    address: '',
    latitude: 41.015,
    longitude: 28.979,
    isLive: false,
  });
  console.log('  ✓ native location messages get text fallback and metadata');
}

{
  const event = await extractBridgeEvent({
    msg: {
      key: { id: 'poll-1', remoteJid: '[email protected]', fromMe: false },
      messageTimestamp: 123,
      message: {
        pollCreationMessage: {
          name: 'Approve deploy?',
          options: [{ optionName: 'Approve' }, { optionName: 'Deny' }],
          selectableOptionsCount: 1,
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
  });

  assert.equal(event.mediaType, 'poll');
  assert.equal(event.body, '[Poll: Approve deploy? Options: Approve, Deny]');
  assert.deepEqual(event.nativeMetadata.poll.options, ['Approve', 'Deny']);
  console.log('  ✓ poll creation messages get text fallback and metadata');
}

// -- outbound media/poll helpers -----------------------------------------
{
  const payload = mediaPayloadForFile({
    buffer: Buffer.from('gif89a'),
    filePath: '/tmp/loop.gif',
    mediaType: 'image',
    caption: 'loop',
  });

  assert.ok(payload.image, 'pure helper fallback keeps raw GIF as image bytes');
  assert.equal(payload.gifPlayback, undefined);
  assert.equal(payload.mimetype, 'image/gif');
  assert.equal(payload.caption, 'loop');
  console.log('  ✓ local GIF helper fallback stays truthful; live bridge converts to gifPlayback when possible');
}

{
  const payload = buildPollPayload({
    question: 'Proceed?',
    options: ['Approve', 'Deny'],
    selectableCount: 1,
  });

  assert.equal(payload.poll.name, 'Proceed?');
  assert.deepEqual(payload.poll.values, ['Approve', 'Deny']);
  assert.equal(payload.poll.selectableCount, 1);
  assert.equal(Buffer.isBuffer(payload.poll.messageSecret), true);
  assert.equal(payload.poll.messageSecret.length, 32);
  assert.deepEqual(pollCreationMessageFromPayload(payload), {
    messageContextInfo: {
      messageSecret: payload.poll.messageSecret,
    },
    pollCreationMessageV3: {
      name: 'Proceed?',
      options: [{ optionName: 'Approve' }, { optionName: 'Deny' }],
      selectableOptionsCount: 1,
    },
  });
  console.log('  ✓ poll payload primitive carries a cacheable vote secret');
}

{
  const pollCreation = {
    key: {
      id: 'poll-creation',
      remoteJid: '[email protected]',
      fromMe: true,
    },
    message: {
      messageContextInfo: {
        messageSecret: Buffer.from('0123456789abcdef0123456789abcdef'),
      },
      pollCreationMessageV3: {
        name: 'Proceed?',
        options: [{ optionName: 'Approve' }, { optionName: 'Deny' }],
        selectableOptionsCount: 1,
      },
    },
  };
  const voteKey = {
    id: 'vote-message',
    remoteJid: '[email protected]',
    participant: '[email protected]',
    fromMe: false,
  };
  const encryptedVote = {
    encPayload: Buffer.from('payload'),
    encIv: Buffer.from('iv'),
  };

  const attempts = [];
  const pollUpdate = pollUpdateForAggregation({
    pollUpdateMessage: {
      pollCreationMessageKey: pollCreation.key,
      vote: encryptedVote,
      senderTimestampMs: 123,
    },
    pollUpdateMessageKey: voteKey,
    pollCreation,
    decryptPollVote: (vote, ctx) => {
      attempts.push({ pollCreatorJid: ctx.pollCreatorJid, voterJid: ctx.voterJid });
      assert.equal(vote, encryptedVote);
      assert.equal(ctx.pollMsgId, 'poll-creation');
      assert.equal(ctx.pollEncKey, pollCreation.message.messageContextInfo.messageSecret);
      if (ctx.pollCreatorJid !== 'creator-lid@lid') {
        throw new Error('wrong creator jid');
      }
      assert.equal(ctx.voterJid, '[email protected]');
      return {
        selectedOptions: [createHash('sha256').update(Buffer.from('Approve')).digest()],
      };
    },
    getKeyAuthor: (key, meId = 'me') => (key?.fromMe ? meId : key?.participant || key?.remoteJid || ''),
    meId: '[email protected]',
    pollCreatorJids: ['[email protected]', 'creator-lid@lid'],
  });

  assert.deepEqual(attempts.map(item => item.pollCreatorJid), ['[email protected]', 'creator-lid@lid']);

  assert.equal(pollUpdate.pollUpdateMessageKey.id, 'vote-message');
  assert.equal(pollUpdate.senderTimestampMs, 123);
  const aggregation = getAggregateVotesInPollMessage({
    message: pollCreation.message,
    pollUpdates: [pollUpdate],
  });
  assert.deepEqual(
    aggregation.map(option => ({ name: option.name, voters: option.voters })),
    [
      { name: 'Approve', voters: ['[email protected]'] },
      { name: 'Deny', voters: [] },
    ],
  );
  console.log('  ✓ encrypted poll upserts are wrapped into Baileys aggregation shape');
}

// -- media download failure containment (port of nanoclaw#2895) -----------
{
  // A throwing downloadMedia (expired CDN URL) must not reject out of
  // extractBridgeEvent — before this guard the whole upsert batch died and
  // the message was silently dropped.
  const event = await extractBridgeEvent({
    msg: {
      key: { id: 'img-fail-1', remoteJid: '[email protected]', fromMe: false },
      messageTimestamp: 123,
      message: { imageMessage: { caption: '', mimetype: 'image/jpeg' } },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15551234567',
    downloadMedia: async () => { throw new Error('Failed to fetch stream from https://mmg.whatsapp.net/x'); },
    cacheDirs: { image: mkdtempSync(path.join(tmpdir(), 'wa-media-')) },
  });
  assert.equal(event.hasMedia, true);
  assert.equal(event.mediaUrls.length, 0);
  assert.equal(event.body, '[image could not be downloaded]');
  console.log('  ✓ failed media download is contained and surfaced in body');
}

{
  // Captioned message keeps the caption and appends the failure note.
  const event = await extractBridgeEvent({
    msg: {
      key: { id: 'doc-fail-1', remoteJid: '[email protected]', fromMe: false },
      messageTimestamp: 123,
      message: { documentMessage: { caption: 'see attached', fileName: 'q.pdf', mimetype: 'application/pdf' } },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15551234567',
    downloadMedia: async () => { throw new Error('boom'); },
    cacheDirs: { document: mkdtempSync(path.join(tmpdir(), 'wa-media-')) },
  });
  assert.equal(event.body, 'see attached\n[document could not be downloaded]');
  assert.equal(event.mediaUrls.length, 0);
  console.log('  ✓ captioned failed download keeps caption and appends note');
}

// -- quoted message envelopes --------------------------------------------
{
  // WhatsApp wraps disappearing (ephemeral), view-once and re-shared
  // document messages in envelope types. The quote extractor must see
  // through them, or a reply to such a message keeps its quoted ID but
  // loses the quoted text entirely (#106066).
  for (const [fixture, quotedMessage] of [
    ['plain conversation', { conversation: 'Example appointment at 11:40' }],
    ['ephemeral-wrapped', {
      ephemeralMessage: { message: { conversation: 'Example appointment at 11:40' } },
    }],
    ['view-once wrapped', {
      viewOnceMessageV2: { message: { conversation: 'Example appointment at 11:40' } },
    }],
    ['document-with-caption envelope', {
      documentWithCaptionMessage: {
        message: { documentMessage: { caption: 'the signed contract', fileName: 'contract.pdf' } },
      },
    }],
    ['extended text inside ephemeral', {
      ephemeralMessage: {
        message: { extendedTextMessage: { text: 'Example appointment at 11:40' } },
      },
    }],
  ]) {
    const event = await extractBridgeEvent({
      msg: {
        key: { id: `reply-${fixture}`, remoteJid: '[email protected]', fromMe: false },
        messageTimestamp: 123,
        message: {
          extendedTextMessage: {
            text: 'confirmed',
            contextInfo: {
              stanzaId: 'original-id',
              participant: '[email protected]',
              quotedMessage,
            },
          },
        },
      },
      chatId: '[email protected]',
      senderId: '[email protected]',
      senderNumber: '15550001111',
      botIds: ['[email protected]'],
      downloadMedia: async () => Buffer.from(''),
    });
    assert.equal(event.quotedMessageId, 'original-id', fixture);
    assert.equal(event.hasQuotedMessage, true, fixture);
    if (fixture === 'document-with-caption envelope') {
      assert.equal(event.quotedText, 'the signed contract', fixture);
    } else {
      assert.equal(event.quotedText, 'Example appointment at 11:40', fixture);
    }
  }
  console.log('  ✓ quoted message text survives ephemeral/view-once/document envelopes');
}

{
  // Nested envelopes (ephemeral wrapping viewOnce wrapping the payload) and
  // the second envelope position: quoted text must resolve there as well.
  const quotedMessage = {
    ephemeralMessage: {
      message: {
        viewOnceMessageV2: {
          message: { extendedTextMessage: { text: 'Example appointment at 11:40' } },
        },
      },
    },
  };
  const event = await extractBridgeEvent({
    msg: {
      key: { id: 'reply-nested', remoteJid: '[email protected]', fromMe: false },
      messageTimestamp: 123,
      message: {
        ephemeralMessage: {
          message: {
            extendedTextMessage: {
              text: 'confirmed',
              contextInfo: { stanzaId: 'original-id', participant: '[email protected]', quotedMessage },
            },
          },
        },
      },
    },
    chatId: '[email protected]',
    senderId: '[email protected]',
    senderNumber: '15550001111',
    botIds: ['[email protected]'],
    downloadMedia: async () => Buffer.from(''),
  });
  assert.equal(event.quotedMessageId, 'original-id');
  assert.equal(event.hasQuotedMessage, true);
  assert.equal(event.quotedText, 'Example appointment at 11:40');
  console.log('  ✓ nested envelopes: quote text resolves through both layers');
}

console.log('\n✅ All WhatsApp native bridge helper tests passed.');