feat(text): suporte a linkPreviewOverride (fork v2.3.7-lp)

Contorna a lib de link-preview do Baileys que falha com shorteners
(amzn.to, bit.ly, etc) permitindo o caller pre-montar o preview
(title, description, canonicalUrl, thumbnail).

Se data.linkPreviewOverride vier no body de POST /message/sendText,
textMessage monta um WAUrlInfo pronto e entrega ao sock.sendMessage
como linkPreview objeto (em vez de boolean), fazendo Baileys renderizar
extendedTextMessage com card preview -- igual WhatsApp oficial.

Preserva a URL original do texto (nao altera o que o usuario ve) --
canonicalUrl eh so o campo interno do card do WhatsApp.

Arquivos:
- src/api/dto/sendMessage.dto.ts: LinkPreviewOverride + Metadata
- src/api/integrations/channel/whatsapp/whatsapp.baileys.service.ts:
  textMessage monta WAUrlInfo; sendMessageWithTyping prioriza override
- src/validate/message.schema.ts: linkPreviewOverride no schema do text

Uso (body POST /message/sendText/:instance):
  {
    "number": "553196018045",
    "text": "Oferta: https://amzn.to/ABC",
    "linkPreviewOverride": {
      "title": "Produto na Amazon",
      "description": "Descricao og:description",
      "canonicalUrl": "https://www.amazon.com.br/dp/XXX",
      "thumbnailUrl": "https://.../og-image.jpg"
    }
  }

Mantem compatibilidade: se linkPreviewOverride ausente, comportamento
original (Baileys decide via linkPreview boolean).

Author: ligge

package-lock.json

@@ -5,11 +5,29 @@ export class Quoted {
   message: proto.IMessage;
 }
 
+/**
+ * Forked patch (ligge/evolution-api v2.3.7-lp): permite injetar preview
+ * de link pre-montado, contornando a lib de link-preview do Baileys que
+ * falha com shorteners (amzn.to, bit.ly, etc). O dispatcher resolve o
+ * shortener + scrape de og:* e envia estes campos prontos.
+ */
+export class LinkPreviewOverride {
+  title?: string;
+  description?: string;
+  /** URL canonica que o Baileys vai usar no card (sem trocar a URL do texto) */
+  canonicalUrl?: string;
+  /** URL da imagem de thumbnail; Baileys baixa e embute */
+  thumbnailUrl?: string;
+  /** Alternativa: base64 puro (sem prefixo data:) da thumbnail em JPEG */
+  jpegThumbnail?: string;
+}
+
 export class Options {
   delay?: number;
   presence?: WAPresence;
   quoted?: Quoted;
   linkPreview?: boolean;
+  linkPreviewOverride?: LinkPreviewOverride;
   encoding?: boolean;
   mentionsEveryOne?: boolean;
   mentioned?: string[];
@@ -41,6 +59,8 @@ export class Metadata {
   delay?: number;
   quoted?: Quoted;
   linkPreview?: boolean;
+  /** Patch fork: preview de link pre-montado (contorna Baileys com shorteners) */
+  linkPreviewOverride?: LinkPreviewOverride;
   mentionsEveryOne?: boolean;
   mentioned?: string[];
   encoding?: boolean;

src/api/dto/sendMessage.dto.ts

@@ -2338,7 +2338,14 @@ export class BaileysStartupService extends ChannelStartupService {
         }
       }
 
-      const linkPreview = options?.linkPreview != false ? undefined : false;
+      // Forked patch (v2.3.7-lp): override tem prioridade. Se o caller
+      // passou um objeto WAUrlInfo pronto, usa-o; senao, delega ao Baileys
+      // (undefined = auto-detect, false = desabilita).
+      const linkPreview: any = options?.linkPreviewOverride
+        ? options.linkPreviewOverride
+        : options?.linkPreview != false
+          ? undefined
+          : false;
 
       let quoted: WAMessage;
 
@@ -2633,6 +2640,31 @@ export class BaileysStartupService extends ChannelStartupService {
       throw new BadRequestException('Text is required');
     }
 
+    // Forked patch (v2.3.7-lp): monta WAUrlInfo se veio linkPreviewOverride
+    // (contorna Baileys link-preview que falha com shorteners)
+    let linkPreviewOverride: any = undefined;
+    if (data.linkPreviewOverride) {
+      const ov = data.linkPreviewOverride;
+      const urlMatch = text.match(/https?:\/\/\S+/i);
+      if (urlMatch) {
+        linkPreviewOverride = {
+          'matched-text': urlMatch[0],
+          matchedText: urlMatch[0],
+          'canonical-url': ov.canonicalUrl ?? urlMatch[0],
+          canonicalUrl: ov.canonicalUrl ?? urlMatch[0],
+          title: ov.title,
+          description: ov.description,
+          ...(ov.thumbnailUrl && {
+            thumbnailUrl: ov.thumbnailUrl,
+            'thumbnail-url': ov.thumbnailUrl,
+          }),
+          ...(ov.jpegThumbnail && {
+            jpegThumbnail: Buffer.from(ov.jpegThumbnail, 'base64'),
+          }),
+        };
+      }
+    }
+
     return await this.sendMessageWithTyping(
       data.number,
       { conversation: data.text },
@@ -2641,6 +2673,7 @@ export class BaileysStartupService extends ChannelStartupService {
         presence: 'composing',
         quoted: data?.quoted,
         linkPreview: data?.linkPreview,
+        linkPreviewOverride,
         mentionsEveryOne: data?.mentionsEveryOne,
         mentioned: data?.mentioned,
       },

src/api/integrations/channel/whatsapp/whatsapp.baileys.service.ts

@@ -72,6 +72,17 @@ export const textMessageSchema: JSONSchema7 = {
     number: { ...numberDefinition },
     text: { type: 'string' },
     linkPreview: { type: 'boolean' },
+    // Forked patch (v2.3.7-lp): preview de link pre-montado pra shorteners
+    linkPreviewOverride: {
+      type: 'object',
+      properties: {
+        title: { type: 'string' },
+        description: { type: 'string' },
+        canonicalUrl: { type: 'string' },
+        thumbnailUrl: { type: 'string' },
+        jpegThumbnail: { type: 'string' },
+      },
+    },
     delay: {
       type: 'integer',
       description: 'Enter a value in milliseconds',