/**
 * @file ToggleableLedDevice.ino
 * @brief Modern replacement example inspired by the legacy Wokwi prototype.
 * Demonstrates a loop-less, event-driven hardware button press triggering an LED toggle
 * using framework Event handlers and class-encapsulated Actuator Commands.
 */

#include <Arduino.h>
#include <ModestIoT.h>

// --- 1. EVENT-DRIVEN APPLICATION MEDIATOR ---

class ToggleableLedDevice : public Device {
    private:
    Button toggleLedButton; // Purpose-driven semantic member name
    Led statusLed;          // Purpose-driven semantic member name

    public:
    /**
     * @param buttonPin GPIO target connected to the physical pushbutton.
     * @param ledPin GPIO target connected to the physical status LED.
     * @param timerChannel Dedicated hardware 64-bit timer group index (0-3).
     */
    ToggleableLedDevice(int buttonPin, int ledPin, uint8_t timerChannel = 0)
    : Device(50, timerChannel), // Setup polling intervals at a safe 50ms task tick
    toggleLedButton(buttonPin, 200, this), // Pass pin, 200ms debounce window, and parent context
    statusLed(ledPin, false, this)              // Pass pin, false initial active state, and parent context
    {
        // 1. Launch internal background task workers with a safe queue boundary depth of 5
        initializeAsynchronousEngine(5);

        // 2. Register the button object pointer to the scheduler grid
        // mapped directly to its pre-defined pressed event token.
        appendSensorToScheduler(&toggleLedButton, Sensor::MEASURE_DATA_REQUESTED_EVENT_IDENTIFIER);
    }

    /**
     * @brief Inversion of Control interface contract handler.
     * Intercepts framework events dispatched from the background worker tasks.
     * @param event The triggered event context payload.
     */
    void on(Event event) override {
            // Intercept and evaluate the specific pre-defined button event token
        if (event.identifier == Button::BUTTON_PRESSED_EVENT_IDENTIFIER) {

            // Route the pre-instantiated static toggle command directly to the actuator.
            // The mediator maintains no local state tracking variables or toggles!
            statusLed.handle(Led::TOGGLE_LED_COMMAND);

            Serial.println("[ToggableLedDevice] Toggle LED Button press event caught -> LED toggle dispatched.");
        }
    }
};

// --- 2. DECLARATIVE RUNTIME CANVAS ---

// Clean configuration canvas constants aligned perfectly with member variable naming
static const int     TOGGLE_BUTTON_PIN  = 26; // Mapped pushbutton GPIO
static const int     STATUS_LED_PIN     = 27;  // Onboard ESP32 diagnostic blue LED
static const uint8_t CORE_TIMER_CHANNEL = 0;

static ToggleableLedDevice* applicationNode = nullptr;

void setup() {
    Serial.begin(115200);

    // Boot the framework application.
    // Background execution queues, FreeRTOS tasks, and hardware alarm vectors launch automatically!
    applicationNode = new ToggleableLedDevice(TOGGLE_BUTTON_PIN, STATUS_LED_PIN, CORE_TIMER_CHANNEL);

    Serial.println("[System Boot] Loop-less interactive toggle node active.");
}

void loop() {
    // 100% of execution resources are permanently yielded to background FreeRTOS workers
    vTaskDelay(pdMS_TO_TICKS(60000));
}