Patternflow

// ═══════════════════════════════════════════════════════════
// PatternFlow - audio-react, as a feature
//
// The fourth port, and the one that tested the boundary the RFC drew
// around the device's own UI. Audio is not only a web page: it has a row
// on the NETWORK screen and a knob that turns it off, because somebody
// standing at the panel should be able to stop it reacting.
//
// Rather than let the sketch keep naming this one feature, the menu learned
// to list features generically: expose `shortName`, `isRuntimeEnabled` and
// `setRuntimeEnabled` and the NETWORK screen shows a row and toggles it.
// The core still owns the menu — it just no longer knows what audio is.
//
// It is also the only feature that runs a server of its own (the websocket on
// PF_AUDIO_WS_PORT), which the seam allows: the rule is only that the loop
// hook must not block.
//
// License: MIT
// ═══════════════════════════════════════════════════════════
#pragma once
#include "audio_config.h"

#include <Preferences.h>
#include "../pf_feature.h"
#include "core_audio_ws.h"

namespace PFFeatureAudio {

inline void setup() {
  // The runtime switch survives reboots; the feature owns its own key.
  Preferences prefs;
  prefs.begin("patternflow", /*readOnly=*/true);
  PatternflowAudio::setRuntimeEnabled(prefs.getBool("audio_runtime", true));
  prefs.end();
}

inline bool isRuntimeEnabled() { return PatternflowAudio::isRuntimeEnabled(); }

inline void setRuntimeEnabled(bool on) {
  PatternflowAudio::setRuntimeEnabled(on);
  Preferences prefs;
  prefs.begin("patternflow", /*readOnly=*/false);
  prefs.putBool("audio_runtime", on);
  prefs.end();
}

inline void onNetwork() {
  PatternflowAudio::begin();
  // onNetwork runs on every (re)connection; the routes are registered once.
  static bool routesUp = false;
  if (routesUp) return;
  routesUp = true;
  WebServer& s = PatternflowHttp::server();
  s.on("/api/audio", HTTP_GET, []() {
    String j = "{\"audioRuntime\":";
    j += isRuntimeEnabled() ? "true" : "false";
    j += ",\"audioClients\":";
    j += PatternflowAudio::clientCount();
    j += "}";
    PatternflowHttp::server().sendHeader("Cache-Control", "no-store");
    PatternflowHttp::server().send(200, "application/json", j);
  });
  s.on("/api/audio", HTTP_POST, []() {
    WebServer& s = PatternflowHttp::server();
    if (s.hasArg("on")) {
      const String v = s.arg("on");
      setRuntimeEnabled(v == "1" || v == "true");
    }
    String j = "{\"ok\":true,\"audioRuntime\":";
    j += isRuntimeEnabled() ? "true" : "false";
    j += "}";
    s.sendHeader("Cache-Control", "no-store");
    s.send(200, "application/json", j);
  });
}

inline void loop(const PFFeatureFrame&) {
  PatternflowAudio::handle();
}

// Audio contributes deltas (a beat nudges a knob) and lane values (a band's
// level drives a mapped parameter).
inline void fillInput(InputFrame& input) {
  for (int i = 0; i < 4; i++) {
    int audioDelta = PatternflowAudio::consumeKnobDelta(i);
    if (input.knobDeltas[i] == 0) input.knobDeltas[i] = audioDelta;
    input.knobAudioActive[i] = PatternflowAudio::isActive(i);
    input.knobAudioValue[i] = PatternflowAudio::value(i);
  }
}

// Whether audio is switched on, and whether anything is connected — both
// specific to this feature. What the lanes are actually doing is core's to
// report (`lanes` / `laneActive` in /api/status): audio is not the only
// thing that drives them, and what a source is sending is not what the
// pattern ends up seeing.
//
// Neither
// was visible from outside the device: a browser could complete a websocket
// handshake, send knob messages, and have every one of them silently dropped
// because the AUD row on the NETWORK screen was off — with nothing anywhere
// saying so. The page reported CONNECTED and the panel did not move.
inline void appendStatus(String& json) {
  json += ",\"audioRuntime\":";
  json += PatternflowAudio::isRuntimeEnabled() ? "true" : "false";
  json += ",\"audioClients\":";
  json += PatternflowAudio::clientCount();
}

inline const PFFeature descriptor = {
    "audio",
    "audio",
    setup,
    onNetwork,
    loop,
    nullptr,       // observeFrame
    fillInput,
    nullptr,       // onUserInput
    nullptr,       // claimsPattern
    nullptr,       // takePattern
    nullptr,       // onSleep
    nullptr,       // requestSleep
    "AUD",         // shortName - the NETWORK screen row
    isRuntimeEnabled,
    setRuntimeEnabled,
    appendStatus,
    nullptr,       // drawOverlay
    nullptr,       // navPath - no console page
    nullptr,       // navLabel
    nullptr,       // navDesc
};

}  // namespace PFFeatureAudio