Add Device Detection Support

stubs/wit_world/imports/device_detection.py の WIT bindings から始め、Viceroy の device-detection 実装を調べて、利用可能なテストレスポンスを確認します。関数ベースの lookup API と、将来互換性のある未知のフィールドを持つ DeviceInfo dataclass を追加し、その後、合成レスポンスまたは適切な xfail ケースを使って、パース、エラーハンドリング、マッチしない lookup をテストします。

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