🚀 New Feature: Stream Command for HID Event Sequences

This PR adds a powerful new stream command to AXe that enables executing complex sequences of HID events from JSON input, supporting both batch and streaming execution modes.

✨ Key Features

• 📝 JSON-based event sequences - Define complex automation workflows in JSON
• 🎯 All HID event types supported - tap, swipe, type, key, button, touch, delay, gesture
• ⚡ Dual execution modes - Batch (single composite) or Streaming (sequential)
• ⏱️ Precise timing control - Pre/post delays, global defaults, event-specific durations
• 🛡️ Comprehensive validation - Input validation, dry-run mode, error handling
• 📊 Rich feedback - Summaries, verbose output, progress tracking
• 🔧 Flexible input - Files, stdin, or inline JSON

🏗️ Architecture

The implementation follows AXe's existing patterns and leverages the IDB library's FBSimulatorHIDEvent composite event capabilities:

• EventSequence.swift - Data models with full validation
• EventSequenceParser.swift - JSON parsing with comprehensive error handling
• HIDEventFactory.swift - Converts parsed events to FBSimulatorHIDEvent objects
• Stream.swift - Main CLI command with batch/streaming execution

📚 Usage Examples

Simple tap sequence

axe stream --json '{
  "events": [
    {"type": "tap", "parameters": {"x": 100, "y": 200}},
    {"type": "delay", "parameters": {"duration": 1.0}},
    {"type": "tap", "parameters": {"x": 300, "y": 400}}
  ]
}' --udid SIMULATOR_UDID

Complex automation from file

axe stream --file login-automation.json --mode streaming --udid SIMULATOR_UDID

Validation and testing

# Validate without executing
axe stream --file sequence.json --validate-only

# Dry run to see execution plan
axe stream --file sequence.json --dry-run --udid SIMULATOR_UDID

# Generate examples
axe stream --example > example.json

📁 Files Added

• Commands/Stream.swift - Main CLI command implementation
• Models/EventSequence.swift - Data models and validation
• Utilities/EventSequenceParser.swift - JSON parsing and validation
• Utilities/HIDEventFactory.swift - HID event creation and execution planning
• Tests/StreamTests.swift - Comprehensive test coverage
• Examples/event-sequences/ - Example JSON files and documentation

🎯 Use Cases

• UI Automation - Complex user interaction workflows
• Testing - Repeatable test sequences with precise timing
• Game Input - Multi-touch and complex input patterns
• Accessibility Testing - Varied input pattern testing

🔍 Example JSON Structure

{
  "metadata": {
    "name": "Login Automation",
    "description": "Automated login sequence"
  },
  "settings": {
    "default_delay": 0.3,
    "stop_on_error": true,
    "max_execution_time": 60.0
  },
  "events": [
    {
      "type": "tap",
      "parameters": {"x": 200, "y": 300},
      "pre_delay": 1.0,
      "id": "tap_username_field",
      "description": "Tap on username field"
    },
    {
      "type": "type", 
      "parameters": {"text": "[email protected]"},
      "post_delay": 0.5
    }
  ]
}

✅ Testing

• Full unit test coverage for all components
• Validation testing for all event types
• Error handling and edge case testing
• Example file validation

📖 Documentation

• Comprehensive README with examples and best practices
• JSON schema generation for validation
• Inline help and examples in CLI
• Example files covering common use cases

This implementation provides a solid foundation for complex HID event automation while maintaining AXe's existing architecture and patterns.

💻 View my work • About Codegen