devices

type DeviceConnection struct {
	Type  string `json:"type"`  // "mac", "ip", "bluetooth", etc.
	Value string `json:"value"` // The connection identifier value
}

type DeviceEntry struct {
	// Core identification
	ID          string             `json:"id"`          // Unique device ID
	Identifiers []DeviceIdentifier `json:"identifiers"` // Multiple identifiers
	Connections []DeviceConnection `json:"connections"` // Network connections

	// Device information
	Name         string     `json:"name,omitempty"`
	Manufacturer string     `json:"manufacturer,omitempty"`
	Model        string     `json:"model,omitempty"`
	ModelID      string     `json:"model_id,omitempty"`
	DeviceType   DeviceType `json:"device_type"`

	// Version information
	HWVersion string `json:"hw_version,omitempty"`
	SWVersion string `json:"sw_version,omitempty"`

	// Configuration and capabilities
	SupportedPorts     []int    `json:"supported_ports,omitempty"`
	SupportedProtocols []string `json:"supported_protocols,omitempty"`
	HasGPS             bool     `json:"has_gps,omitempty"`

	// Organization and area (SpaceDF specific)
	Organization string  `json:"organization,omitempty"`
	AreaID       *string `json:"area_id,omitempty"`

	// Status and control
	DisabledBy *string `json:"disabled_by,omitempty"`
	ConfigURL  *string `json:"config_url,omitempty"`

	// Timestamps
	CreatedAt time.Time  `json:"created_at"`
	UpdatedAt time.Time  `json:"updated_at"`
	LastSeen  *time.Time `json:"last_seen,omitempty"`

	// Additional metadata
	Metadata map[string]interface{} `json:"metadata,omitempty"`
}

type DeviceIdentifier struct {
	Type  string `json:"type"`  // "lorawan", "satellite", "network", etc.
	Key   string `json:"key"`   // "dev_eui", "esn", "mac", etc.
	Value string `json:"value"` // The actual identifier value
}

type DeviceParser interface {
	// GetDeviceType returns the device type this parser handles
	GetDeviceType() DeviceType

	// CanParse checks if this parser can handle the given payload
	// This is used for device detection/routing
	CanParse(payload *RawPayload) bool

	// Parse converts raw payload into structured ParsedData
	Parse(ctx context.Context, payload *RawPayload) (*ParsedData, error)

	// Validate performs device-specific validation on the parsed data
	Validate(data *ParsedData) error
}

type DeviceParserWithMetadata interface {
	DeviceParser
	GetMetadata() ParserMetadata
}

type DeviceType string

type GatewayInfo struct {
	GatewayID string   `json:"gateway_id"`
	RSSI      int      `json:"rssi"`
	SNR       float64  `json:"snr"`
	Location  Location `json:"location,omitempty"`
}

type IdentifierDetector struct{}

type Location struct {
	Latitude  float64 `json:"latitude"`
	Longitude float64 `json:"longitude"`
	Altitude  float64 `json:"altitude,omitempty"`
}

type ParsedData struct {
	DeviceEUI    string                 `json:"device_eui"`
	DeviceType   DeviceType             `json:"device_type"`
	Timestamp    time.Time              `json:"timestamp"`
	Location     *Location              `json:"location,omitempty"`
	SensorData   map[string]interface{} `json:"sensor_data"`
	BatteryLevel *float64               `json:"battery_level,omitempty"`
	RawData      string                 `json:"raw_data,omitempty"`
}

type ParserMetadata struct {
	DeviceType     DeviceType
	Manufacturer   string
	Model          string
	Version        string
	Description    string
	SupportedPorts []int // FPorts this device uses
}

type RawPayload struct {
	DeviceEUI string                 `json:"device_eui"`
	FPort     int                    `json:"fport"`
	Data      string                 `json:"data"` // Base64-encoded payload
	Timestamp time.Time              `json:"timestamp"`
	RxInfo    []GatewayInfo          `json:"rx_info"`
	Metadata  map[string]interface{} `json:"metadata"`

	// Enhanced with multi-identifier support
	Identifiers []DeviceIdentifier `json:"identifiers,omitempty"` // Multiple device IDs
	Connections []DeviceConnection `json:"connections,omitempty"` // Network connections
}