Add Device Detection Support

Comienza con los bindings de WIT en stubs/wit_world/imports/device_detection.py e inspecciona la implementación de device-detection de Viceroy para determinar las respuestas de prueba disponibles. Añade la API de búsqueda basada en funciones y el dataclass DeviceInfo con campos desconocidos compatibles con futuras versiones; después, prueba el análisis, el manejo de errores y las búsquedas sin coincidencias mediante respuestas sintéticas o casos xfail apropiados.

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