Portable Mood Companion

#include <Arduino.h>
#include <WiFi.h>
#include <HTTPClient.h>
#include <ArduinoJson.h>
#include <time.h>
#include "secrets.h"

// This companion reads a Google Sheet through your private Google Apps Script web app.
// Each visible spreadsheet tab is one task. A task is complete when that tab has a row
// dated today in column A. The Apps Script returns the status as JSON.


// Hoisted type definitions
struct DailyTask {
  String name;
  bool complete;
};


// Forward declarations
bool wifiIsConfigured();
bool sheetsIsConfigured();
String urlEncode(const String &value);
void connectWiFi();
bool sleepingHours(const tm &local);
void applyAutomaticMode();
void updateWeather();
void refreshDailyTasks();
uint8_t getDailyTaskCount();
void onTouchGesture(const String &gesture);
void onRecognisedSpeech(String phrase);

constexpr char TIME_ZONE[] = "GMT0BST,M3.5.0/1,M10.5.0/2";
constexpr float KINGSTON_LAT = 51.4123F;
constexpr float KINGSTON_LON = -0.3007F;

// PERSONALITY RULES: change these values to suit the companion.
constexpr uint8_t SLEEP_START_HOUR = 22;
constexpr uint8_t SLEEP_END_HOUR = 7;
constexpr float COLD_TEMPERATURE_C = 8.0F;
constexpr float HOT_TEMPERATURE_C = 25.0F;
constexpr uint32_t WEATHER_REFRESH_MS = 30UL * 60UL * 1000UL;
constexpr uint32_t TASK_REFRESH_MS = 15UL * 60UL * 1000UL;
constexpr uint8_t MAX_DAILY_TASKS = 20;



bool silentMode = false;
String activeAnimation = "idle";
String weatherText = "Waiting for Wi-Fi";
float temperatureC = NAN;
DailyTask dailyTasks[MAX_DAILY_TASKS];
uint8_t dailyTaskCount = 0;
String taskStatusText = "Set up Google Sheets to see daily tasks";
uint32_t lastTaskRefresh = 0;
uint32_t lastWeatherRefresh = 0;

bool wifiIsConfigured() {
  return String(WIFI_SSID) != "YOUR_WIFI_NAME" && String(WIFI_PASSWORD) != "YOUR_WIFI_PASSWORD";
}

bool sheetsIsConfigured() {
  return String(GOOGLE_SHEETS_WEB_APP_URL).startsWith("https://") &&
         String(GOOGLE_SHEETS_SHARED_TOKEN).length() >= 16 &&
         String(GOOGLE_SHEETS_SHARED_TOKEN) != "CHANGE_THIS_TO_A_LONG_RANDOM_SECRET";
}

String urlEncode(const String &value) {
  const char *hex = "0123456789ABCDEF";
  String result;
  for (size_t i = 0; i < value.length(); ++i) {
    uint8_t c = value[i];
    if (isalnum(c) || c == '-' || c == '_' || c == '.') result += (char)c;
    else { result += '%'; result += hex[c >> 4]; result += hex[c & 15]; }
  }
  return result;
}

void connectWiFi() {
  if (!wifiIsConfigured() || WiFi.status() == WL_CONNECTED) return;
  WiFi.mode(WIFI_STA);
  WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
  uint32_t started = millis();
  while (WiFi.status() != WL_CONNECTED && millis() - started < 12000) delay(100);
}

bool sleepingHours(const tm &local) {
  return SLEEP_START_HOUR > SLEEP_END_HOUR
    ? local.tm_hour >= SLEEP_START_HOUR || local.tm_hour < SLEEP_END_HOUR
    : local.tm_hour >= SLEEP_START_HOUR && local.tm_hour < SLEEP_END_HOUR;
}

void applyAutomaticMode() {
  time_t now = time(nullptr);
  tm local{};
  localtime_r(&now, &local);
  if (now > 1700000000 && sleepingHours(local)) activeAnimation = "sleeping";
  else if (!isnan(temperatureC) && temperatureC <= COLD_TEMPERATURE_C) activeAnimation = "cold";
  else if (!isnan(temperatureC) && temperatureC >= HOT_TEMPERATURE_C) activeAnimation = "hot";
  else activeAnimation = "idle";
}

void updateWeather() {
  if (WiFi.status() != WL_CONNECTED) return;
  HTTPClient http;
  String url = "https://api.open-meteo.com/v1/forecast?latitude=" + String(KINGSTON_LAT, 4) +
    "&longitude=" + String(KINGSTON_LON, 4) + "&current=temperature_2m&timezone=Europe%2FLondon";
  if (!http.begin(url)) return;
  if (http.GET() == HTTP_CODE_OK) {
    JsonDocument json;
    if (deserializeJson(json, http.getString()) == DeserializationError::Ok) {
      temperatureC = json["current"]["temperature_2m"] | NAN;
      weatherText = String(temperatureC, 1) + " C";
      applyAutomaticMode();
    }
  }
  http.end();
}

void refreshDailyTasks() {
  if (!sheetsIsConfigured() || WiFi.status() != WL_CONNECTED) return;

  HTTPClient http;
  String url = String(GOOGLE_SHEETS_WEB_APP_URL) + "?token=" +
               urlEncode(GOOGLE_SHEETS_SHARED_TOKEN) + "&action=today";
  http.setTimeout(12000);
  if (!http.begin(url)) {
    taskStatusText = "Could not contact task list";
    return;
  }

  int status = http.GET();
  if (status != HTTP_CODE_OK) {
    taskStatusText = "Task list unavailable (HTTP " + String(status) + ")";
    http.end();
    return;
  }

  JsonDocument json;
  DeserializationError error = deserializeJson(json, http.getString());
  http.end();
  if (error != DeserializationError::Ok || !(json["ok"] | false)) {
    taskStatusText = json["message"] | "Task list reply was invalid";
    return;
  }

  dailyTaskCount = 0;
  uint8_t completedCount = 0;
  for (JsonObject task : json["tasks"].as<JsonArray>()) {
    if (dailyTaskCount >= MAX_DAILY_TASKS) break;
    dailyTasks[dailyTaskCount].name = String(task["name"] | "Unnamed task");
    dailyTasks[dailyTaskCount].complete = task["complete"] | false;
    if (dailyTasks[dailyTaskCount].complete) completedCount++;
    dailyTaskCount++;
  }
  taskStatusText = String(completedCount) + "/" + String(dailyTaskCount) + " tasks done today";
  Serial.println(taskStatusText);
  for (uint8_t i = 0; i < dailyTaskCount; ++i) {
    Serial.printf("%s: %s\n", dailyTasks[i].name.c_str(), dailyTasks[i].complete ? "done" : "not done");
  }
}

// The display page calls this to obtain the task names and their done/not-done state.
// Swipe to the Tasks page in the display layer; this data is refreshed only on Wi-Fi.
uint8_t getDailyTaskCount() { return dailyTaskCount; }
const DailyTask &getDailyTask(uint8_t index) { return dailyTasks[index]; }

void onTouchGesture(const String &gesture) {
  if (gesture == "tap") activeAnimation = "happy";
  else if (gesture == "long-press") silentMode = !silentMode;
  else if (gesture == "tasks-page") refreshDailyTasks();
}

void onRecognisedSpeech(String phrase) {
  phrase.toLowerCase();
  if (phrase.indexOf("hello") >= 0) activeAnimation = "happy";
  if (phrase.indexOf("silent") >= 0 || phrase.indexOf("be quiet") >= 0) silentMode = true;
  if (phrase.indexOf("sound on") >= 0 || phrase.indexOf("make noise") >= 0) silentMode = false;
}

void setup() {
  Serial.begin(115200);
  delay(250);
  connectWiFi();
  configTzTime(TIME_ZONE, "pool.ntp.org", "time.google.com");
}

void loop() {
  connectWiFi();
  if (WiFi.status() == WL_CONNECTED && (lastWeatherRefresh == 0 || millis() - lastWeatherRefresh >= WEATHER_REFRESH_MS)) {
    lastWeatherRefresh = millis();
    updateWeather();
  }
  if (WiFi.status() == WL_CONNECTED && sheetsIsConfigured() &&
      (lastTaskRefresh == 0 || millis() - lastTaskRefresh >= TASK_REFRESH_MS)) {
    lastTaskRefresh = millis();
    refreshDailyTasks();
  }
  applyAutomaticMode();
  delay(20);
}