feat(decoder): distinguish BLE and WiFi MAC addresses

Add Beacon struct and UplinkFeatureBle interface so consumers can differentiate BLE scan uplinks (port 3) from WiFi access point uplinks. Port 3 in tagsl/v1 now correctly implements UplinkFeatureBle instead of UplinkFeatureWiFi.

Closes #160

Author: michaelbeutler

.secrets.baseline

@@ -1387,7 +1387,7 @@
         "filename": "pkg/decoder/tagsl/v1/decoder_test.go",
         "hashed_secret": "d76d7d922e691ced5b77d86c9c4282866a26f89f",
         "is_verified": false,
-        "line_number": 2355,
+        "line_number": 2364,
         "is_secret": false
       }
     ],
@@ -2228,5 +2228,5 @@
       }
     ]
   },
-  "generated_at": "2026-01-01T19:55:45Z"
+  "generated_at": "2026-02-23T10:32:59Z"
 }

pkg/decoder/decoder.go

@@ -127,6 +127,15 @@ type UplinkFeatureWiFi interface {
 	GetAccessPoints() []AccessPoint
 }
 
+type Beacon struct {
+	MAC  string `json:"mac"`
+	RSSI *int8  `json:"rssi"`
+}
+
+type UplinkFeatureBle interface {
+	GetBeacons() []Beacon
+}
+
 type UplinkFeatureMoving interface {
 	// IsMoving returns true if the device is moving, otherwise it returns false.
 	IsMoving() bool

pkg/decoder/decoder_test.go

@@ -55,6 +55,7 @@ func TestNewDecodedUplink_IsAndGetFeatures(t *testing.T) {
 	var _ UplinkFeatureHumidity = (*dummyHumidity)(nil)
 	var _ UplinkFeaturePressure = (*dummyPressure)(nil)
 	var _ UplinkFeatureWiFi = (*dummyWiFi)(nil)
+	var _ UplinkFeatureBle = (*dummyBle)(nil)
 	var _ UplinkFeatureMoving = (*dummyMoving)(nil)
 	var _ UplinkFeatureDutyCycle = (*dummyDutyCycle)(nil)
 	var _ UplinkFeatureConfig = (*dummyConfig)(nil)
@@ -113,6 +114,10 @@ type dummyWiFi struct{}
 
 func (*dummyWiFi) GetAccessPoints() []AccessPoint { return nil }
 
+type dummyBle struct{}
+
+func (*dummyBle) GetBeacons() []Beacon { return nil }
+
 type dummyMoving struct{}
 
 func (*dummyMoving) IsMoving() bool { return false }

pkg/decoder/tagsl/v1/decoder.go

@@ -88,7 +88,7 @@ func (t TagSLv1Decoder) getConfig(port uint8) (common.PayloadConfig, error) {
 				{Name: "Rssi6", Start: 45, Length: 1, Optional: true},
 			},
 			TargetType: reflect.TypeOf(Port3Payload{}),
-			Features:   []decoder.Feature{decoder.FeatureWiFi},
+			Features:   []decoder.Feature{decoder.FeatureBle},
 		}, nil
 	case 4:
 		return common.PayloadConfig{

pkg/decoder/tagsl/v1/decoder_test.go

@@ -2194,6 +2194,15 @@ func TestFeatures(t *testing.T) {
 					t.Fatalf("expected non nil access points")
 				}
 			}
+			if decodedPayload.Is(decoder.FeatureBle) {
+				ble, ok := decodedPayload.Data.(decoder.UplinkFeatureBle)
+				if !ok {
+					t.Fatalf("expected UplinkFeatureBle, got %T", decodedPayload)
+				}
+				if ble.GetBeacons() == nil {
+					t.Fatalf("expected non nil beacons")
+				}
+			}
 			if decodedPayload.Is(decoder.FeatureMoving) {
 				moving, ok := decodedPayload.Data.(decoder.UplinkFeatureMoving)
 				if !ok {

pkg/decoder/tagsl/v1/port3.go

@@ -42,52 +42,52 @@ type Port3Payload struct {
 	Rssi6          *int8   `json:"rssi6" validate:"gte=-120,lte=-20"`
 }
 
-var _ decoder.UplinkFeatureWiFi = &Port3Payload{}
+var _ decoder.UplinkFeatureBle = &Port3Payload{}
 
-func (p Port3Payload) GetAccessPoints() []decoder.AccessPoint {
-	accessPoints := []decoder.AccessPoint{}
+func (p Port3Payload) GetBeacons() []decoder.Beacon {
+	beacons := []decoder.Beacon{}
 
 	if p.Mac1 != "" && p.Rssi1 != 0 {
-		accessPoints = append(accessPoints, decoder.AccessPoint{
+		beacons = append(beacons, decoder.Beacon{
 			MAC:  p.Mac1,
 			RSSI: &p.Rssi1,
 		})
 	}
 
 	if p.Mac2 != nil && p.Rssi2 != nil {
-		accessPoints = append(accessPoints, decoder.AccessPoint{
+		beacons = append(beacons, decoder.Beacon{
 			MAC:  *p.Mac2,
 			RSSI: p.Rssi2,
 		})
 	}
 
 	if p.Mac3 != nil && p.Rssi3 != nil {
-		accessPoints = append(accessPoints, decoder.AccessPoint{
+		beacons = append(beacons, decoder.Beacon{
 			MAC:  *p.Mac3,
 			RSSI: p.Rssi3,
 		})
 	}
 
 	if p.Mac4 != nil && p.Rssi4 != nil {
-		accessPoints = append(accessPoints, decoder.AccessPoint{
+		beacons = append(beacons, decoder.Beacon{
 			MAC:  *p.Mac4,
 			RSSI: p.Rssi4,
 		})
 	}
 
 	if p.Mac5 != nil && p.Rssi5 != nil {
-		accessPoints = append(accessPoints, decoder.AccessPoint{
+		beacons = append(beacons, decoder.Beacon{
 			MAC:  *p.Mac5,
 			RSSI: p.Rssi5,
 		})
 	}
 
 	if p.Mac6 != nil && p.Rssi6 != nil {
-		accessPoints = append(accessPoints, decoder.AccessPoint{
+		beacons = append(beacons, decoder.Beacon{
 			MAC:  *p.Mac6,
 			RSSI: p.Rssi6,
 		})
 	}
 
-	return accessPoints
+	return beacons
 }