feat: add ContactAttachmentPayload.Phone() to extract phone from vCard

Author: Saveliy Yudin

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [v0.3.0] - 2026-02-23
+
+### Added
+- `ContactAttachmentPayload.Phone()` — extracts phone number from VCFInfo (vCard TEL field)
+
 ## [v0.2.2] - 2026-02-15
 
 ### Added

types.go

@@ -3,6 +3,7 @@ package maxigo
 import (
 	"encoding/json"
 	"fmt"
+	"strings"
 )
 
 // ChatType represents the type of chat.
@@ -479,6 +480,23 @@ type ContactAttachmentPayload struct {
 	MaxInfo *User   `json:"max_info,omitempty"`
 }
 
+// Phone extracts the phone number from VCFInfo (vCard TEL field).
+// Returns an empty string if VCFInfo is nil or contains no TEL field.
+func (p *ContactAttachmentPayload) Phone() string {
+	if p.VCFInfo == nil {
+		return ""
+	}
+	for _, line := range strings.Split(*p.VCFInfo, "\n") {
+		line = strings.TrimRight(line, "\r")
+		if strings.HasPrefix(strings.ToUpper(line), "TEL") {
+			if idx := strings.LastIndex(line, ":"); idx >= 0 {
+				return strings.TrimSpace(line[idx+1:])
+			}
+		}
+	}
+	return ""
+}
+
 // ContactAttachment represents a contact attachment in a message.
 type ContactAttachment struct {
 	AttachmentType

types_test.go

@@ -547,3 +547,69 @@ func TestParseAttachments(t *testing.T) {
 		}
 	})
 }
+
+func TestContactAttachmentPayload_Phone(t *testing.T) {
+	tests := []struct {
+		name    string
+		payload ContactAttachmentPayload
+		want    string
+	}{
+		{
+			name:    "nil VCFInfo",
+			payload: ContactAttachmentPayload{},
+			want:    "",
+		},
+		{
+			name: "standard vCard with TEL;TYPE=cell",
+			payload: ContactAttachmentPayload{
+				VCFInfo: strPtr("BEGIN:VCARD\nVERSION:3.0\nTEL;TYPE=cell:79001234567\nFN:John\nEND:VCARD"),
+			},
+			want: "79001234567",
+		},
+		{
+			name: "plain TEL field",
+			payload: ContactAttachmentPayload{
+				VCFInfo: strPtr("BEGIN:VCARD\nTEL:+79001234567\nEND:VCARD"),
+			},
+			want: "+79001234567",
+		},
+		{
+			name: "TEL with multiple type params",
+			payload: ContactAttachmentPayload{
+				VCFInfo: strPtr("BEGIN:VCARD\nTEL;TYPE=work;TYPE=voice:+74951234567\nEND:VCARD"),
+			},
+			want: "+74951234567",
+		},
+		{
+			name: "no TEL field",
+			payload: ContactAttachmentPayload{
+				VCFInfo: strPtr("BEGIN:VCARD\nFN:John\nEND:VCARD"),
+			},
+			want: "",
+		},
+		{
+			name: "vCard with \\r\\n line endings",
+			payload: ContactAttachmentPayload{
+				VCFInfo: strPtr("BEGIN:VCARD\r\nTEL;TYPE=cell:79991234567\r\nEND:VCARD"),
+			},
+			want: "79991234567",
+		},
+		{
+			name: "lowercase tel field",
+			payload: ContactAttachmentPayload{
+				VCFInfo: strPtr("BEGIN:VCARD\ntel;type=cell:79991234567\nEND:VCARD"),
+			},
+			want: "79991234567",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			got := tt.payload.Phone()
+			if got != tt.want {
+				t.Errorf("Phone() = %q, want %q", got, tt.want)
+			}
+		})
+	}
+
+}