Add Device Detection Support

Inizia con i binding WIT in stubs/wit_world/imports/device_detection.py ed esamina l’implementazione di device-detection di Viceroy per determinare le risposte di test disponibili. Aggiungi l’API di lookup basata su funzioni e il dataclass DeviceInfo con campi sconosciuti compatibili con il futuro, quindi testa il parsing, la gestione degli errori e i lookup senza corrispondenza usando risposte sintetiche o casi xfail appropriati.

Overview

Add support for Fastly's Device Detection API, which provides device capabilities and characteristics based on User-Agent strings.

WIT Interface

interface device-detection {
  use types.{error};

  /// Returns JSON-encoded device data for a User-Agent string
  lookup: func(user-agent: string, max-len: u64) -> result<option<string>, error>;
}

WIT bindings: stubs/wit_world/imports/device_detection.py

API Design

• Simple function-based API: lookup(user_agent: str) -> Optional[DeviceInfo]
• Parse JSON response into @dataclass with _extra field for forward compatibility
• Return None for lookups that don't match any known device
• Fields typically include: is_mobile, is_desktop, is_tablet, is_bot, device_type, brand, model, etc.

Forward Compatibility: Use @dataclass with _extra: dict field to capture unknown fields (same pattern as Geo). Provides type hints for known fields while allowing future fields to be accessible.

Cross-SDK Comparison: All SDKs expose simple lookup(user_agent) returning parsed JSON. Rust returns DeviceInfo struct, Go returns *DeviceDetection, JS returns object. All have similar field structure (device type, name, vendor, etc.).

Viceroy Testing

Device detection support in Viceroy is limited or stubbed. The WIT interface exists but may not have full test data support via test.toml configuration like other features.

Tests should either:

• Use xfail markers for functionality that requires production device detection data
• Mock the User-Agent lookup if Viceroy provides stub/default responses
• Focus on API wrapper behavior (parsing, error handling) with synthetic responses

Check Viceroy's device detection implementation to determine exact testing capabilities.

Reference

• Fastly Device Detection Documentation