feat: add purge cache tool

Author: wellwelwel

.env.example

@@ -0,0 +1,2 @@
+CF_ZONE_ID=''
+CF_TOKEN=''

.github/workflows/cd_purge.yml

@@ -0,0 +1,35 @@
+name: '🗑️ CD (Website) — Purge Cache'
+
+on:
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    name: Deploy
+    steps:
+      - name: Actions - Checkout
+        uses: actions/checkout@v4
+
+      - name: Actions - Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          check-latest: true
+          node-version: lts/*
+
+      - name: Cache Dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: npm-${{ hashFiles('package-lock.json') }}
+          restore-keys: npm-
+
+      - name: Installing Dependencies
+        run: npm ci
+
+      - name: Purge Cache
+        run: npm run purge
+        env:
+          CF_ZONE_ID: ${{ secrets.CF_ZONE_ID }}
+          CF_TOKEN: ${{ secrets.CF_TOKEN }}

.github/workflows/ci_test.yml

@@ -11,15 +11,16 @@ jobs:
     name: Test
     steps:
       - name: Actions - Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Actions - Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 22
+          check-latest: true
+          node-version: lts/*
 
       - name: Cache Dependencies
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: ~/.npm
           key: npm-${{ hashFiles('package-lock.json') }}

package.json

@@ -20,7 +20,8 @@
     "lint": "prettier --check .",
     "lint:fix": "prettier --write .",
     "update": "pu && npm i && npm update && (npm audit fix || true)",
-    "postupdate": "npm run lint:fix"
+    "postupdate": "npm run lint:fix",
+    "purge": "tsx --env-file-if-exists=.env tools/purge-cache.mts"
   },
   "devDependencies": {
     "@docusaurus/core": "^3.9.2",

tools/purge-cache.mts

@@ -0,0 +1,44 @@
+import { env, exit } from 'node:process';
+
+const { CF_ZONE_ID, CF_TOKEN, CI } = env;
+
+if (!CF_ZONE_ID || !CF_TOKEN) {
+  console.log('Skipping: Cloudflare not set.');
+  exit(0);
+}
+
+const url = `https://api.cloudflare.com/client/v4/zones/${CF_ZONE_ID.trim()}/purge_cache`;
+const body = { purge_everything: true };
+const headers = {
+  Authorization: `Bearer ${CF_TOKEN.trim()}`,
+  'Content-Type': 'application/json',
+};
+
+try {
+  const response = await fetch(url, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(body),
+  });
+
+  if (!response.ok) {
+    const error = await response.json();
+    const errorMessage =
+      typeof error === 'object' &&
+      error !== null &&
+      'errors' in error &&
+      Array.isArray(error.errors) &&
+      error.errors[0]?.message
+        ? error.errors[0].message
+        : response.statusText;
+    throw new Error(`Failed to purge cache: ${errorMessage}`);
+  }
+
+  await response.json();
+  console.log('Cache purged successfully');
+} catch (error) {
+  console.error('Error purging cache.');
+
+  if (!CI) throw error;
+  else exit(1);
+}