feat: link attachment

Author: aiko-chan-ai

DOCS.md

@@ -1607,6 +1607,9 @@ interface Attachment {
     duration?: number
     stickerId?: number
     previewUrl?: string
+    // For link attachments
+    description?: string    // Link description/subtitle
+    sourceText?: string     // Source domain text
     // For E2EE media download (only available in E2EE messages)
     mediaKey?: string      // Base64 encoded encryption key
     mediaSha256?: string   // Base64 encoded file SHA256

DOCS_VI.md

@@ -1607,6 +1607,9 @@ interface Attachment {
     duration?: number
     stickerId?: number
     previewUrl?: string
+    // Dành cho link attachments
+    description?: string    // Mô tả/subtitle của link
+    sourceText?: string     // Tên miền nguồn
     // Dành cho tải media E2EE (chỉ có trong tin nhắn E2EE)
     mediaKey?: string      // Khóa mã hóa dạng Base64
     mediaSha256?: string   // SHA256 file gốc dạng Base64

bridge-go/bridge/events.go

@@ -3,6 +3,7 @@ package bridge
 import (
 	"context"
 	"fmt"
+	"net/url"
 	"strconv"
 	"strings"
 	"time"
@@ -69,18 +70,20 @@ type Thread struct {
 
 // Attachment represents a media attachment
 type Attachment struct {
-	Type       string  `json:"type"` // "image", "video", "audio", "file", "sticker", "gif", "voice", "location"
-	URL        string  `json:"url,omitempty"`
-	FileName   string  `json:"fileName,omitempty"`
-	MimeType   string  `json:"mimeType,omitempty"`
-	FileSize   int64   `json:"fileSize,omitempty"`
-	Width      int     `json:"width,omitempty"`
-	Height     int     `json:"height,omitempty"`
-	Duration   int     `json:"duration,omitempty"` // in seconds for audio/video
-	StickerID  int64   `json:"stickerId,omitempty"`
-	Latitude   float64 `json:"latitude,omitempty"`
-	Longitude  float64 `json:"longitude,omitempty"`
-	PreviewURL string  `json:"previewUrl,omitempty"`
+	Type        string  `json:"type"` // "image", "video", "audio", "file", "sticker", "gif", "voice", "location", "link"
+	URL         string  `json:"url,omitempty"`
+	FileName    string  `json:"fileName,omitempty"`
+	MimeType    string  `json:"mimeType,omitempty"`
+	FileSize    int64   `json:"fileSize,omitempty"`
+	Width       int     `json:"width,omitempty"`
+	Height      int     `json:"height,omitempty"`
+	Duration    int     `json:"duration,omitempty"` // in seconds for audio/video
+	StickerID   int64   `json:"stickerId,omitempty"`
+	Latitude    float64 `json:"latitude,omitempty"`
+	Longitude   float64 `json:"longitude,omitempty"`
+	PreviewURL  string  `json:"previewUrl,omitempty"`
+	Description string  `json:"description,omitempty"` // For link attachments
+	SourceText  string  `json:"sourceText,omitempty"`  // Domain/source for link attachments
 	// For E2EE media download
 	MediaKey       []byte `json:"mediaKey,omitempty"`
 	MediaSHA256    []byte `json:"mediaSha256,omitempty"`
@@ -442,12 +445,25 @@ func (c *Client) convertWrappedMessage(msg *table.WrappedMessage) *Message {
 
 	// Handle XMA attachments (links, shares, etc.)
 	for _, xma := range msg.XMAAttachments {
-		if xma.PreviewUrl != "" {
+		// Get the actual URL from CTA ActionUrl or fallback to xma.ActionUrl
+		var linkURL string
+		if xma.CTA != nil && xma.CTA.ActionUrl != "" {
+			linkURL = extractURLFromLPHP(xma.CTA.ActionUrl)
+		} else if xma.ActionUrl != "" {
+			linkURL = extractURLFromLPHP(xma.ActionUrl)
+		}
+
+		// Only add as link attachment if we have a URL or preview
+		if linkURL != "" || xma.PreviewUrl != "" {
 			m.Attachments = append(m.Attachments, &Attachment{
-				Type:       "link",
-				URL:        xma.ActionUrl,
-				PreviewURL: xma.PreviewUrl,
-				FileName:   xma.TitleText,
+				Type:        "link",
+				URL:         linkURL,
+				PreviewURL:  xma.PreviewUrl,
+				FileName:    xma.TitleText,
+				Description: xma.SubtitleText,
+				SourceText:  xma.SourceText,
+				Width:       int(xma.PreviewWidth),
+				Height:      int(xma.PreviewHeight),
 			})
 		}
 	}
@@ -949,11 +965,23 @@ func (c *Client) extractE2EEMessage(e *events.FBMessage, senderID int64) *E2EEMe
 								msg.Mentions = mentions
 							}
 						}
-						if extMsg.GetCanonicalURL() != "" {
+						if extMsg.GetCanonicalURL() != "" || extMsg.GetMatchedText() != "" {
 							att := &Attachment{
-								Type:     "link",
-								URL:      extMsg.GetCanonicalURL(),
-								FileName: extMsg.GetTitle(),
+								Type:        "link",
+								URL:         extMsg.GetCanonicalURL(),
+								FileName:    extMsg.GetTitle(),
+								Description: extMsg.GetDescription(),
+							}
+							// If no canonical URL, use matched text as the URL
+							if att.URL == "" && extMsg.GetMatchedText() != "" {
+								att.URL = extMsg.GetMatchedText()
+							}
+							// Try to decode thumbnail for preview
+							if thumb, err := extMsg.DecodeThumbnail(); err == nil && thumb != nil {
+								if ancillary := thumb.GetAncillary(); ancillary != nil {
+									att.Width = int(ancillary.GetWidth())
+									att.Height = int(ancillary.GetHeight())
+								}
 							}
 							msg.Attachments = append(msg.Attachments, att)
 						}
@@ -1137,3 +1165,22 @@ func (c *Client) extractE2EEStickerAttachment(sticker *waConsumerApplication.Con
 
 	return att
 }
+
+// extractURLFromLPHP extracts the actual URL from Facebook's l.php redirect URL
+// e.g., "https://l.facebook.com/l.php?u=https%3A%2F%2Fexample.com&h=..." -> "https://example.com"
+func extractURLFromLPHP(addr string) string {
+	if addr == "" {
+		return ""
+	}
+	parsed, err := url.Parse(addr)
+	if err != nil {
+		return addr
+	}
+	// Check if this is a Facebook l.php redirect
+	if parsed.Path == "/l.php" || strings.HasSuffix(parsed.Path, "/l.php") {
+		if u := parsed.Query().Get("u"); u != "" {
+			return u
+		}
+	}
+	return addr
+}

src/types.ts

@@ -255,9 +255,9 @@ export type AttachmentType = "image" | "video" | "audio" | "file" | "sticker" |
 export interface Attachment {
     /** Attachment type */
     type: AttachmentType;
-    /** URL to download media (for regular messages) */
+    /** URL to download media (for regular messages) or the link URL (for link attachments) */
     url?: string;
-    /** Original filename */
+    /** Original filename or link title */
     fileName?: string;
     /** MIME type (e.g., 'image/jpeg') */
     mimeType?: string;
@@ -277,12 +277,10 @@ export interface Attachment {
     longitude?: number;
     /** Preview/thumbnail URL */
     previewUrl?: string;
-    
-    // === E2EE Media Download Fields ===
-    // These fields are only available for E2EE (end-to-end encrypted) messages.
-    // Use client.downloadE2EEMedia() to download and decrypt the media.
-    
-    /** Base64 encoded media encryption key (E2EE only) */
+    /** Link description/subtitle (for link attachments) */
+    description?: string;
+    /** Source domain text (for link attachments) */
+    sourceText?: string;
     mediaKey?: string;
     /** Base64 encoded SHA256 hash of the decrypted file (E2EE only) */
     mediaSha256?: string;