Supabase library version 1.0.0

Author: zumatt

.gitignore

@@ -0,0 +1,12 @@
+# VSCode
+.vscode
+.vscode/.browse.c_cpp.db*
+.vscode/c_cpp_properties.json
+.vscode/launch.json
+.vscode/ipch
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*

examples/SupabaseESP32_Demo/SupabaseESP32_Demo.ino

@@ -0,0 +1,60 @@
+/*
+   Supabase Library for ESP32
+
+       Created by Matteo Subet - Last version 05 March 2024
+    
+    Created based on the library https://github.com/clock27-lab/unofficial-esp32-supabase
+*/
+
+#include <SupabaseESP32.h>
+
+// Replace with your Supabase URL, table name and API key
+#define supabaseUrl  "INSERT YOUR URL HERE"
+#define tableRealtime  "INSERT YOUR TABLE NAME HERE"
+#define supabaseApiKey  "INSERT YOUR API KEY HERE"
+
+// Setup the Supabase client
+SUPABASE supabaseClient(supabaseUrl, supabaseApiKey, tableRealtime);
+
+// Replace with your network credentials
+const char *ssid = "INSERT YOUR SSID HERE";  
+const char *password = "INSERT YOUR PASSWORD HERE";
+
+void setup()
+{
+    Serial.begin(115200);
+
+    WiFi.mode(WIFI_STA);
+    WiFi.begin(ssid, password);
+
+    // Wait for connection
+    while (WiFi.status() != WL_CONNECTED){delay(500); Serial.print(".");}
+
+    //Begin the connection to the database
+    supabaseClient.begin();
+
+    delay(2000);
+    //Read the data from the table
+    supabaseClient.read();
+
+    delay(2000);
+    //Update a specific row with a new value
+        int rowId = 1;
+        String column = "column_name";
+        double value = 100.0;
+    supabaseClient.update(rowId, column, value);
+
+    delay(2000);
+    //Insert a new row with a new value
+        column = "column_name";
+        value = 100.0;
+    supabaseClient.insert(column, value);
+
+    delay(2000);
+    //Read the data again to see the changes
+    supabaseClient.read();
+}
+
+void loop(){
+    //Do nothing
+}

library.json

@@ -0,0 +1,26 @@
+{
+    "name": "Supabase ESP32 Connection",
+    "keywords": "supabase, arduino, realtime database, database, IoT",
+    "description": "A library to connect to Supabase's Realtime Database from an ESP32 in realtime with API Key authentication.",
+    "repository":
+    {
+      "type": "git",
+      "url": "https://github.com/zumatt/Supabase-ESP32"
+    },
+    "authors":
+    [
+      {
+        "name": "Matteo Subet",
+        "email": "matteo.subet@supsi.ch",
+        "url": "http://link.zumat.ch",
+        "maintainer": true
+      }
+    ],
+    "dependencies":
+    {
+    },
+    "version": "1.0.0",
+    "frameworks": "arduino",
+    "platforms": "espressif32",
+    "examples": "examples/*/*.ino"
+  }

library.properties

@@ -0,0 +1,9 @@
+name=Supabase-ESP32
+version=1.0.0
+author=Matteo Subet
+maintainer=Matteo Subet https://github.com/zumatt
+sentence=Arduino Library to communicate with Supabase.io 
+paragraph=Arduino Library to communicate with Supabase.io. The possible functions are the following: -insert -update -read
+category=Communication
+url=https://github.com/zumatt/Supabase-ESP32
+includes=WiFi.h, HTTPClient.h

src/SupabaseESP32.cpp

@@ -0,0 +1,76 @@
+#include "SupabaseESP32.h"
+
+// #if ESP32
+HTTPClient http;
+// #endif
+
+String supabase_url;
+String supabase_key;
+String supabase_bearer;
+String supabase_table;
+
+SUPABASE::SUPABASE(String url, String key, String tableName)
+{
+    supabase_table = tableName;
+    supabase_url = url + "/" + supabase_table;
+    supabase_key = key;
+    supabase_bearer = "Bearer " + key;
+}
+
+SUPABASE::~SUPABASE() {}
+
+void SUPABASE::begin()
+{
+    Serial.println(supabase_url);
+    http.begin(supabase_url.c_str());
+    http.addHeader("apikey", supabase_key);
+    http.addHeader("Authorization", supabase_bearer);
+    http.addHeader("Content-Type", "application/json");
+    http.addHeader("Prefer", "return=representation");
+}
+
+int SUPABASE::update(int rowId, String column, double value)
+{
+    String url = supabase_url + "?id=eq." + String(rowId);
+    http.begin(url.c_str());
+    http.addHeader("apikey", supabase_key);
+    http.addHeader("Authorization", supabase_bearer);
+    http.addHeader("Content-Type", "application/json");
+    http.addHeader("Prefer", "return=minimal");
+    String supabase_data = "{\"" + column + "\":" + String(value) + "}";
+    int httpResponseCode = http.PATCH(supabase_data);
+    http.end();
+    return httpResponseCode;
+}
+
+int SUPABASE::insert(String column, double value)
+{
+    http.begin(supabase_url.c_str());
+    http.addHeader("apikey", supabase_key);
+    http.addHeader("Authorization", supabase_bearer);
+    http.addHeader("Content-Type", "application/json");
+    http.addHeader("Prefer", "return=minimal");
+    String supabase_data = "{\"" + column + "\":" + String(value) + "}";
+    int httpResponseCode = http.POST(supabase_data);
+    http.end();
+    return httpResponseCode;
+}
+
+
+String SUPABASE::read()
+{
+    String url = supabase_url + "?select=*";
+    http.begin(url.c_str());
+    http.addHeader("apikey", supabase_key);
+    int httpResponseCode = http.GET();
+    String payload = http.getString();
+    
+    Serial.println("DATA READ!");
+    Serial.print("HTTP GET: ");
+    Serial.println(httpResponseCode);
+    Serial.print("HTTP Payload: ");
+    Serial.println(payload);
+    
+    http.end();
+    return payload;
+}

src/SupabaseESP32.h

@@ -0,0 +1,20 @@
+/*
+   Supabase Library for ESP32
+
+       Created by Matteo Subet - Last version 05 March 2024
+    
+    Created based on the library https://github.com/clock27-lab/unofficial-esp32-supabase
+*/
+
+#include <WiFi.h>
+#include <HTTPClient.h>
+class SUPABASE
+{
+public:
+    SUPABASE(String url, String key, String tableName);
+    ~SUPABASE();
+    void begin();
+    int update(int rowId, String column, double value);
+    int insert(String column, double value);
+    String read();
+};