cache reset

Author: max-ostapenko

README.md

@@ -520,6 +520,32 @@ Returns a JSON object with the following schema:
 }
 ```
 
+### `POST /v1/cache-reset`
+
+Resets all caches in the API. This endpoint requires a POST request.
+
+```bash
+curl --request POST \
+  --url 'https://{{HOST}}/v1/cache-reset'
+```
+
+Returns a JSON object with the following schema:
+
+```json
+{
+    "success": true,
+    "message": "All caches have been reset",
+    "before": {
+        "queryCache": 150,
+        "dateCache": 12
+    },
+    "after": {
+        "queryCache": 0,
+        "dateCache": 0
+    }
+}
+```
+
 ## Testing
 
 ```bash

src/__tests__/routes.test.js

@@ -362,4 +362,35 @@ describe('API Routes', () => {
       expect(res.headers['timing-allow-origin']).toEqual('*');
     });
   });
+
+  describe('Cache Management', () => {
+    it('should provide cache stats', async () => {
+      const res = await request(app)
+        .get('/v1/cache-stats')
+        .expect(200);
+
+      expect(res.body).toHaveProperty('queryCache');
+      expect(res.body).toHaveProperty('dateCache');
+      expect(res.body).toHaveProperty('config');
+    });
+
+    it('should reset cache on POST request', async () => {
+      const res = await request(app)
+        .post('/v1/cache-reset')
+        .expect(200);
+
+      expect(res.body).toHaveProperty('success', true);
+      expect(res.body).toHaveProperty('message');
+      expect(res.body).toHaveProperty('before');
+      expect(res.body).toHaveProperty('after');
+    });
+
+    it('should handle cache reset OPTIONS request', async () => {
+      const res = await request(app)
+        .options('/v1/cache-reset')
+        .expect(204);
+
+      expect(res.headers['access-control-allow-methods']).toContain('POST');
+    });
+  });
 });

src/index.js

@@ -51,7 +51,7 @@ const getController = async (name) => {
 // Helper function to set CORS headers
 const setCORSHeaders = (res) => {
   res.setHeader('Access-Control-Allow-Origin', '*');
-  res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+  res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
   res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Timing-Allow-Origin');
   res.setHeader('Access-Control-Max-Age', '86400');
 };
@@ -163,6 +163,11 @@ const handleRequest = async (req, res) => {
       const { getCacheStats } = await import('./utils/controllerHelpers.js');
       const stats = getCacheStats();
       sendJSONResponse(res, stats);
+    } else if (pathname === '/v1/cache-reset' && req.method === 'POST') {
+      // Cache reset endpoint
+      const { resetCache } = await import('./utils/controllerHelpers.js');
+      const result = resetCache();
+      sendJSONResponse(res, result);
     } else {
       // 404 Not Found
       res.statusCode = 404;

src/utils/controllerHelpers.js

@@ -318,6 +318,31 @@ const validateTechnologyArray = (technologyParam) => {
   }
 };
 
+/**
+ * Reset all caches
+ * @returns {Object} Reset operation result
+ */
+const resetCache = () => {
+  const beforeStats = {
+    queryCache: queryResultCache.size,
+    dateCache: latestDateCache.size
+  };
+
+  // Clear both caches
+  queryResultCache.clear();
+  latestDateCache.clear();
+
+  return {
+    success: true,
+    message: 'All caches have been reset',
+    before: beforeStats,
+    after: {
+      queryCache: queryResultCache.size,
+      dateCache: latestDateCache.size
+    }
+  };
+};
+
 export {
   REQUIRED_PARAMS,
   FIRESTORE_IN_LIMIT,
@@ -331,5 +356,6 @@ export {
   setCachedQueryResult,
   getCacheStats,
   executeQuery,
-  validateTechnologyArray
+  validateTechnologyArray,
+  resetCache
 };

test-api.sh

@@ -116,4 +116,27 @@ test_endpoint "/v1/page-weight" "?technology=WordPress&geo=ALL&rank=ALL&start=la
 # Test audits endpoint
 test_endpoint "/v1/audits" "?technology=WordPress&geo=ALL&rank=ALL&start=latest"
 
+# Test cache stats endpoint
+echo "Testing cache stats endpoint..."
+test_endpoint "/v1/cache-stats" ""
+
+# Test cache reset endpoint
+echo "Testing cache reset endpoint..."
+echo "Checking cache reset: http://localhost:3000/v1/cache-reset"
+response=$(curl -s -w "\n%{http_code}" -X POST "http://localhost:3000/v1/cache-reset")
+http_code=$(echo "$response" | tail -n1)
+body=$(echo "$response" | sed '$d')
+
+echo "$body" | jq .
+echo "Status code: $http_code"
+
+if [[ $http_code -ne 200 ]]; then
+  echo "Error: Cache reset endpoint returned non-200 status code"
+  exit 1
+fi
+
+echo ""
+echo "----------------------"
+echo ""
+
 echo "API tests complete! All endpoints returned 200 status code and CORS is properly configured."