fix: address review feedback

- Restore version 11.14.0 (stale package.json from the spike branch)
- Matomo config fetch: hourly revalidate instead of force-cache, so
  dashboard changes propagate without a deploy
- Skip Secure cookie attribute on plain-http localhost (Safari rejects)
- Complete defineABFlag JSDoc

Author: pettinarip

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ethereum-org-website",
-  "version": "11.13.0",
+  "version": "11.14.0",
   "license": "MIT",
   "private": true,
   "scripts": {

src/components/AB/TestDebugPanel.tsx

@@ -29,7 +29,9 @@ function getCookie(name: string): string | null {
 
 /** Set a cookie with path=/ and security attributes */
 function setCookie(name: string, value: string) {
-  document.cookie = `${name}=${value}; path=/; max-age=86400; Secure; SameSite=Strict`
+  // Safari rejects Secure cookies on plain-http localhost (pnpm dev)
+  const secure = window.location.protocol === "https:" ? "; Secure" : ""
+  document.cookie = `${name}=${value}; path=/; max-age=86400${secure}; SameSite=Strict`
 }
 
 /** Delete a cookie */

src/lib/ab-testing/flags.ts

@@ -65,6 +65,7 @@ export type ABFlag = ReturnType<typeof flag<number, MatomoEntities>>
  *
  * @param key Must exactly match the experiment name in Matomo - a mismatch
  *   doesn't error, everyone silently gets the original variant.
+ * @param description Human-readable summary shown in Flags SDK tooling.
  * @param numVariants Total variant count including the original (default 2).
  */
 export const defineABFlag = (

src/lib/ab-testing/matomo-adapter.ts

@@ -47,7 +47,9 @@ async function fetchMatomoExperiments(): Promise<Record<string, ABTestConfig>> {
       `${matomoUrl}/index.php?module=API&method=AbTesting.getAllExperiments&idSite=${siteId}&format=json&token_auth=${apiToken}`,
       {
         headers: { "User-Agent": "ethereum.org-flags-adapter/1.0" },
-        cache: "force-cache",
+        // Refresh hourly so Matomo dashboard changes (pause, re-weight)
+        // propagate without a deploy
+        next: { revalidate: 3600 },
       }
     )