endpoints/about/languages/GET.php

@@ -6,8 +6,10 @@
 
 	use VLW\API\Endpoints;
 	use VLW\Database\Database;
+	use const VLW\FORGEJO_UPDATE_CACHE_PARAM;
 	use VLW\Database\Tables\About\LanguagesTable;
 
+	require_once Path::root("src/Consts.php");
 	require_once Path::root("src/API/Endpoints.php");
 	require_once Path::root("src/Database/Database.php");
 	require_once Path::root("src/Database/Tables/About/Languages.php");
@@ -27,7 +29,11 @@
 				(new Rules(LanguagesTable::BYTES->value))
 					->type(Type::NUMBER)
 					->min(1)
-					->max(parent::SIZE_UINT32)
+					->max(parent::SIZE_UINT32),
+
+				(new Rules(FORGEJO_UPDATE_CACHE_PARAM))
+					->type(Type::BOOLEAN)
+					->default(false)
 			]);
 
 			$this->ruleset->validate_or_exit();
@@ -36,6 +42,11 @@
 		}
 
 		public function main(): Response {
+			// Refresh the language cache if param is set
+			if ($_GET[FORGEJO_UPDATE_CACHE_PARAM]) {
+				(new Call(Endpoints::ABOUT_LANGUAGES->value))->post();
+			}
+
 			return $this->list(LanguagesTable::NAME, LanguagesTable::values(), [
 				LanguagesTable::BYTES->value => Order::DESC
 			]);

endpoints/coffee/stats/GET.php

@@ -6,8 +6,10 @@
 
 	use VLW\API\Endpoints;
 	use VLW\Database\Database;
+	use const VLW\COFFEE_STATS_UPDATE_PARAM;
 	use VLW\Database\Tables\Coffee\StatsTable;
 
+	require_once Path::root("src/Consts.php");
 	require_once Path::root("src/API/Endpoints.php");
 	require_once Path::root("src/Database/Database.php");
 	require_once Path::root("src/Database/Tables/Coffee/Stats.php");
@@ -17,12 +19,24 @@
 
 		public function __construct() {
 			$this->ruleset = new Ruleset(strict: true);
+
+			$this->ruleset->GET([
+				(new Rules(COFFEE_STATS_UPDATE_PARAM))
+					->type(Type::BOOLEAN)
+					->default(false)
+			]);
+
 			$this->ruleset->validate_or_exit();
 
 			parent::__construct();
 		}
 
 		public function main(): Response {
+			// Freshen cache if update flag is set
+			if ($_GET[COFFEE_STATS_UPDATE_PARAM]) {
+				(new Call(Endpoints::COFFEE_STATS->value))->post();
+			}
+			
 			return $this->list(StatsTable::NAME, StatsTable::values());
 		}
 	}

endpoints/search/GET.php

@@ -6,8 +6,10 @@
 
 	use VLW\API\Endpoints;
 	use VLW\Database\Database;
+	use const VLW\SEARCH_UPDATE_CACHE_PARM;
 	use VLW\Database\Tables\Search\{SearchTable, SearchCategoryEnum};
 
+	require_once Path::root("src/Consts.php");
 	require_once Path::root("src/API/Endpoints.php");
 	require_once Path::root("src/Database/Database.php");
 	require_once Path::root("src/Database/Tables/Search/Search.php");
@@ -33,7 +35,11 @@
 
 				(new Rules(SearchTable::CATEGORY->value))
 					->type(Type::ENUM, SearchCategoryEnum::names())
-					->default(null)
+					->default(null),
+
+				(new Rules(SEARCH_UPDATE_CACHE_PARM))
+					->type(Type::BOOLEAN)
+					->default(false)
 			]);
 
 			$this->ruleset->validate_or_exit();
@@ -48,6 +54,11 @@
 		}
 
 		public function main(): Response {
+			// Freshen cache if update flag is set
+			if ($_GET[SEARCH_UPDATE_CACHE_PARM]) {
+				(new Call(Endpoints::SEARCH->value))->post();
+			}
+
 			$result = $this->db->for(SearchTable::NAME);
 
 			if ($_GET[SearchTable::ID->value]) {

endpoints/search/POST.php

@@ -61,7 +61,13 @@
 		}
 
 		public function main(): Response {
+			// Truncate existing cache
+			(new Call(Endpoints::SEARCH->value))->delete();
+
 			$this->index_work();
-			return new Response();
+
+			return $result->num_rows > 0
+				? new Response($result->fetch_all(MYSQLI_ASSOC))
+				: new Response([], 404);
 		}
 	}

endpoints/update/GET.php

@@ -1,26 +0,0 @@
-<?php
-
-	use Reflect\{Response, Path, Call};
-	use ReflectRules\{Ruleset, Rules, Type};
-
-	use VLW\API\Endpoints;
-
-	require_once Path::root("src/API/Endpoints.php");
-
-	class GET_Update {
-		protected Ruleset $ruleset;
-
-		public function __construct() {
-			$this->ruleset = new Ruleset(strict: true);
-			$this->ruleset->validate_or_exit();
-		}
-
-		// Update all runtime database endpoints
-		public function main(): Response {
-			(new Call(Endpoints::SEARCH->value))->post();
-			(new Call(Endpoints::COFFEE_STATS->value))->post();
-			(new Call(Endpoints::ABOUT_LANGUAGES->value))->post();
-
-			return new Response();
-		}
-	}

src/Consts.php

@@ -15,6 +15,7 @@
 	 * Constants for the search API endpoint
 	 */
 	const SEARCH_QUERY_MAX_LENGTH  = 2048;
+	const SEARCH_UPDATE_CACHE_PARM = "update";
 
 	/**
 	 * # Timeline
@@ -23,6 +24,12 @@
 	const TIMELINE_PREVIEW_LIMIT_PARAM = "limit";
 	const TIMELINE_PREVIEW_LIMIT_COUNT = 5;
 
+	/**
+	 * # Coffee
+	 * Constants related to the coffee endpoints
+	 */
+	const COFFEE_STATS_UPDATE_PARAM = "update";
+
 	/**
 	 * # Forgejo
 	 * Constants related to the fetching and caching of real-time prog. language use on Forgejo
@@ -31,3 +38,4 @@
 	const FORGEJO_ENDPOINT_USER            = "/api/v1/users/%s";
 	const FORGEJO_ENDPOINT_SEARCH          = "/api/v1/repos/search?uid=%s";
 	const FORGEJO_SI_BYTE_MULTIPLE         = ["B", "kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+	const FORGEJO_UPDATE_CACHE_PARAM       = "update";

src/Database/Seeds/vlw_reflect.sql

@@ -27,7 +27,6 @@ INSERT INTO `endpoints` (`id`, `active`) VALUES
 ('notes', 1),
 ('playground/coffee', 1),
 ('search', 1),
-('update', 1),
 ('work', 1),
 ('work/actions', 1),
 ('work/tags', 1),