mirror of
https://github.com/daveallie/crosspoint-reader.git
synced 2026-02-04 22:57:50 +03:00
Some checks are pending
CI / build (push) Waiting to run
## Summary - Adds KOReader progress sync integration, allowing CrossPoint to sync reading positions with other KOReader-compatible devices - Stores credentials securely with XOR obfuscation - Uses KOReader's partial MD5 document hashing for cross-device book matching - Syncs position via percentage with estimated XPath for compatibility # Features - Settings: KOReader Username, Password, and Authenticate options - Sync from chapters menu: "Sync Progress" option appears when credentials are configured - Bidirectional sync: Can apply remote progress or upload local progress --------- Co-authored-by: Dave Allie <dave@daveallie.com>
199 lines
5.6 KiB
C++
199 lines
5.6 KiB
C++
#include "KOReaderSyncClient.h"
|
|
|
|
#include <ArduinoJson.h>
|
|
#include <HTTPClient.h>
|
|
#include <HardwareSerial.h>
|
|
#include <WiFi.h>
|
|
#include <WiFiClientSecure.h>
|
|
|
|
#include <ctime>
|
|
|
|
#include "KOReaderCredentialStore.h"
|
|
|
|
namespace {
|
|
// Device identifier for CrossPoint reader
|
|
constexpr char DEVICE_NAME[] = "CrossPoint";
|
|
constexpr char DEVICE_ID[] = "crosspoint-reader";
|
|
|
|
void addAuthHeaders(HTTPClient& http) {
|
|
http.addHeader("Accept", "application/vnd.koreader.v1+json");
|
|
http.addHeader("x-auth-user", KOREADER_STORE.getUsername().c_str());
|
|
http.addHeader("x-auth-key", KOREADER_STORE.getMd5Password().c_str());
|
|
}
|
|
|
|
bool isHttpsUrl(const std::string& url) { return url.rfind("https://", 0) == 0; }
|
|
} // namespace
|
|
|
|
KOReaderSyncClient::Error KOReaderSyncClient::authenticate() {
|
|
if (!KOREADER_STORE.hasCredentials()) {
|
|
Serial.printf("[%lu] [KOSync] No credentials configured\n", millis());
|
|
return NO_CREDENTIALS;
|
|
}
|
|
|
|
std::string url = KOREADER_STORE.getBaseUrl() + "/users/auth";
|
|
Serial.printf("[%lu] [KOSync] Authenticating: %s\n", millis(), url.c_str());
|
|
|
|
HTTPClient http;
|
|
std::unique_ptr<WiFiClientSecure> secureClient;
|
|
WiFiClient plainClient;
|
|
|
|
if (isHttpsUrl(url)) {
|
|
secureClient.reset(new WiFiClientSecure);
|
|
secureClient->setInsecure();
|
|
http.begin(*secureClient, url.c_str());
|
|
} else {
|
|
http.begin(plainClient, url.c_str());
|
|
}
|
|
addAuthHeaders(http);
|
|
|
|
const int httpCode = http.GET();
|
|
http.end();
|
|
|
|
Serial.printf("[%lu] [KOSync] Auth response: %d\n", millis(), httpCode);
|
|
|
|
if (httpCode == 200) {
|
|
return OK;
|
|
} else if (httpCode == 401) {
|
|
return AUTH_FAILED;
|
|
} else if (httpCode < 0) {
|
|
return NETWORK_ERROR;
|
|
}
|
|
return SERVER_ERROR;
|
|
}
|
|
|
|
KOReaderSyncClient::Error KOReaderSyncClient::getProgress(const std::string& documentHash,
|
|
KOReaderProgress& outProgress) {
|
|
if (!KOREADER_STORE.hasCredentials()) {
|
|
Serial.printf("[%lu] [KOSync] No credentials configured\n", millis());
|
|
return NO_CREDENTIALS;
|
|
}
|
|
|
|
std::string url = KOREADER_STORE.getBaseUrl() + "/syncs/progress/" + documentHash;
|
|
Serial.printf("[%lu] [KOSync] Getting progress: %s\n", millis(), url.c_str());
|
|
|
|
HTTPClient http;
|
|
std::unique_ptr<WiFiClientSecure> secureClient;
|
|
WiFiClient plainClient;
|
|
|
|
if (isHttpsUrl(url)) {
|
|
secureClient.reset(new WiFiClientSecure);
|
|
secureClient->setInsecure();
|
|
http.begin(*secureClient, url.c_str());
|
|
} else {
|
|
http.begin(plainClient, url.c_str());
|
|
}
|
|
addAuthHeaders(http);
|
|
|
|
const int httpCode = http.GET();
|
|
|
|
if (httpCode == 200) {
|
|
// Parse JSON response from response string
|
|
String responseBody = http.getString();
|
|
http.end();
|
|
|
|
JsonDocument doc;
|
|
const DeserializationError error = deserializeJson(doc, responseBody);
|
|
|
|
if (error) {
|
|
Serial.printf("[%lu] [KOSync] JSON parse failed: %s\n", millis(), error.c_str());
|
|
return JSON_ERROR;
|
|
}
|
|
|
|
outProgress.document = documentHash;
|
|
outProgress.progress = doc["progress"].as<std::string>();
|
|
outProgress.percentage = doc["percentage"].as<float>();
|
|
outProgress.device = doc["device"].as<std::string>();
|
|
outProgress.deviceId = doc["device_id"].as<std::string>();
|
|
outProgress.timestamp = doc["timestamp"].as<int64_t>();
|
|
|
|
Serial.printf("[%lu] [KOSync] Got progress: %.2f%% at %s\n", millis(), outProgress.percentage * 100,
|
|
outProgress.progress.c_str());
|
|
return OK;
|
|
}
|
|
|
|
http.end();
|
|
|
|
Serial.printf("[%lu] [KOSync] Get progress response: %d\n", millis(), httpCode);
|
|
|
|
if (httpCode == 401) {
|
|
return AUTH_FAILED;
|
|
} else if (httpCode == 404) {
|
|
return NOT_FOUND;
|
|
} else if (httpCode < 0) {
|
|
return NETWORK_ERROR;
|
|
}
|
|
return SERVER_ERROR;
|
|
}
|
|
|
|
KOReaderSyncClient::Error KOReaderSyncClient::updateProgress(const KOReaderProgress& progress) {
|
|
if (!KOREADER_STORE.hasCredentials()) {
|
|
Serial.printf("[%lu] [KOSync] No credentials configured\n", millis());
|
|
return NO_CREDENTIALS;
|
|
}
|
|
|
|
std::string url = KOREADER_STORE.getBaseUrl() + "/syncs/progress";
|
|
Serial.printf("[%lu] [KOSync] Updating progress: %s\n", millis(), url.c_str());
|
|
|
|
HTTPClient http;
|
|
std::unique_ptr<WiFiClientSecure> secureClient;
|
|
WiFiClient plainClient;
|
|
|
|
if (isHttpsUrl(url)) {
|
|
secureClient.reset(new WiFiClientSecure);
|
|
secureClient->setInsecure();
|
|
http.begin(*secureClient, url.c_str());
|
|
} else {
|
|
http.begin(plainClient, url.c_str());
|
|
}
|
|
addAuthHeaders(http);
|
|
http.addHeader("Content-Type", "application/json");
|
|
|
|
// Build JSON body (timestamp not required per API spec)
|
|
JsonDocument doc;
|
|
doc["document"] = progress.document;
|
|
doc["progress"] = progress.progress;
|
|
doc["percentage"] = progress.percentage;
|
|
doc["device"] = DEVICE_NAME;
|
|
doc["device_id"] = DEVICE_ID;
|
|
|
|
std::string body;
|
|
serializeJson(doc, body);
|
|
|
|
Serial.printf("[%lu] [KOSync] Request body: %s\n", millis(), body.c_str());
|
|
|
|
const int httpCode = http.PUT(body.c_str());
|
|
http.end();
|
|
|
|
Serial.printf("[%lu] [KOSync] Update progress response: %d\n", millis(), httpCode);
|
|
|
|
if (httpCode == 200 || httpCode == 202) {
|
|
return OK;
|
|
} else if (httpCode == 401) {
|
|
return AUTH_FAILED;
|
|
} else if (httpCode < 0) {
|
|
return NETWORK_ERROR;
|
|
}
|
|
return SERVER_ERROR;
|
|
}
|
|
|
|
const char* KOReaderSyncClient::errorString(Error error) {
|
|
switch (error) {
|
|
case OK:
|
|
return "Success";
|
|
case NO_CREDENTIALS:
|
|
return "No credentials configured";
|
|
case NETWORK_ERROR:
|
|
return "Network error";
|
|
case AUTH_FAILED:
|
|
return "Authentication failed";
|
|
case SERVER_ERROR:
|
|
return "Server error (try again later)";
|
|
case JSON_ERROR:
|
|
return "JSON parse error";
|
|
case NOT_FOUND:
|
|
return "No progress found";
|
|
default:
|
|
return "Unknown error";
|
|
}
|
|
}
|