fix: add token verification step to debug authentication issues

Author: sshrihar

.github/workflows/test_cloudflare_purge.yml

@@ -18,10 +18,43 @@ jobs:
           echo "Commit: ${{ github.sha }}"
           echo "Host: polygon-docs.polygon.technology"
 
+      - name: Verify Cloudflare Token
+        run: |
+          ZONE_ID=$(echo "${{ secrets.CLOUDFLARE_ZONE }}" | tr -d '[:space:]')
+          AUTH_TOKEN=$(echo "${{ secrets.CLOUDFLARE_AUTH_KEY }}" | tr -d '[:space:]')
+          
+          echo "Zone ID length: ${#ZONE_ID}"
+          echo "Token length: ${#AUTH_TOKEN}"
+          echo "Token preview: ${AUTH_TOKEN:0:10}...${AUTH_TOKEN: -5}"
+          
+          echo "Testing token by fetching zone info..."
+          VERIFY_RESPONSE=$(curl -s -w "\n%{http_code}" -X GET \
+            "https://api.cloudflare.com/client/v4/zones/${ZONE_ID}" \
+            -H "Authorization: Bearer ${AUTH_TOKEN}" \
+            -H "Content-Type: application/json")
+          
+          VERIFY_HTTP_CODE=$(echo "$VERIFY_RESPONSE" | tail -n1)
+          VERIFY_BODY=$(echo "$VERIFY_RESPONSE" | sed '$d')
+          
+          echo "Verify HTTP Status: $VERIFY_HTTP_CODE"
+          if [ "$VERIFY_HTTP_CODE" -ne 200 ]; then
+            echo "❌ Token verification failed!"
+            echo "$VERIFY_BODY" | jq '.' || echo "$VERIFY_BODY"
+            echo ""
+            echo "Common issues:"
+            echo "1. Token may be invalid or expired"
+            echo "2. Token may not have 'Zone.Read' permission"
+            echo "3. Zone ID may be incorrect"
+            exit 1
+          else
+            ZONE_NAME=$(echo "$VERIFY_BODY" | jq -r '.result.name' 2>/dev/null || echo "unknown")
+            echo "✅ Token verified! Zone: $ZONE_NAME"
+            echo "ZONE_ID=${ZONE_ID}" >> $GITHUB_ENV
+            echo "AUTH_TOKEN=${AUTH_TOKEN}" >> $GITHUB_ENV
+          fi
+
       - name: Cloudflare Cache Purge
         run: |
-          ZONE_ID="${{ secrets.CLOUDFLARE_ZONE }}"
-          AUTH_TOKEN="${{ secrets.CLOUDFLARE_AUTH_KEY }}"
           HOST="polygon-docs.polygon.technology"
           
           echo "Purging cache for host: $HOST"
@@ -51,6 +84,13 @@ jobs:
             fi
           else
             echo "❌ HTTP request failed with status $HTTP_CODE"
+            if [ "$HTTP_CODE" -eq 401 ]; then
+              echo ""
+              echo "Authentication failed. Please verify:"
+              echo "1. The API token is valid and not expired"
+              echo "2. The token has 'Zone.Cache Purge' permission"
+              echo "3. The token is for the correct Cloudflare account"
+            fi
             exit 1
           fi