first commit

examples/cache-handler-redis/app/[timezone]/page.tsx

@@ -0,0 +1,68 @@
+import { notFound } from "next/navigation";
+import { CacheStateWatcher } from "../cache-state-watcher";
+import { Suspense } from "react";
+import { RevalidateFrom } from "../revalidate-from";
+import Link from "next/link";
+
+type TimeData = {
+  unixtime: number;
+  datetime: string;
+  timezone: string;
+};
+
+const timeZones = ["cet", "gmt"];
+
+export const revalidate = 500;
+
+export async function generateStaticParams() {
+  return timeZones.map((timezone) => ({ timezone }));
+}
+
+export default async function Page({ params: { timezone } }) {
+  const data = await fetch(
+    `https://worldtimeapi.org/api/timezone/${timezone}`,
+    {
+      next: { tags: ["time-data"] },
+    },
+  );
+
+  if (!data.ok) {
+    notFound();
+  }
+
+  const timeData: TimeData = await data.json();
+
+  return (
+    <>
+      <header className="header">
+        {timeZones.map((timeZone) => (
+          <Link key={timeZone} className="link" href={`/${timeZone}`}>
+            {timeZone.toUpperCase()} Time
+          </Link>
+        ))}
+      </header>
+      <main className="widget">
+        <div className="pre-rendered-at">
+          {timeData.timezone} Time {timeData.datetime}
+        </div>
+        <Suspense fallback={null}>
+          <CacheStateWatcher
+            revalidateAfter={revalidate * 1000}
+            time={timeData.unixtime * 1000}
+          />
+        </Suspense>
+        <RevalidateFrom />
+      </main>
+      <footer className="footer">
+        <Link
+          href={process.env.NEXT_PUBLIC_REDIS_INSIGHT_URL}
+          className="link"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          View RedisInsight &#x21AA;
+        </Link>
+      </footer>
+    </>
+  );
+}

examples/cache-handler-redis/app/cache-state-watcher.tsx

@@ -0,0 +1,50 @@
+"use client";
+
+import { ReactNode, useEffect, useState } from "react";
+
+type CacheStateWatcherProps = { time: number; revalidateAfter: number };
+
+export function CacheStateWatcher({
+  time,
+  revalidateAfter,
+}: CacheStateWatcherProps): ReactNode {
+  const [cacheState, setCacheState] = useState("");
+  const [countDown, setCountDown] = useState("");
+
+  useEffect(() => {
+    let id = -1;
+
+    function check(): void {
+      const now = Date.now();
+
+      setCountDown(
+        Math.max(0, (time + revalidateAfter - now) / 1000).toFixed(3),
+      );
+
+      if (now > time + revalidateAfter) {
+        setCacheState("stale");
+
+        return;
+      }
+
+      setCacheState("fresh");
+
+      id = requestAnimationFrame(check);
+    }
+
+    id = requestAnimationFrame(check);
+
+    return () => {
+      cancelAnimationFrame(id);
+    };
+  }, [revalidateAfter, time]);
+
+  return (
+    <>
+      <div className={`cache-state ${cacheState}`}>
+        Cache state: {cacheState}
+      </div>
+      <div className="stale-after">Stale in: {countDown}</div>
+    </>
+  );
+}

examples/cache-handler-redis/app/global.css

@@ -0,0 +1,102 @@
+*,
+*:before,
+*:after {
+  box-sizing: border-box;
+}
+
+body,
+html {
+  margin: 0;
+  padding: 0;
+  font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+  color: #333;
+  line-height: 1.6;
+  background-color: #f4f4f4;
+}
+
+.widget {
+  background-color: #ffffff;
+  border-radius: 8px;
+  box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
+  margin: 20px auto;
+  padding: 20px;
+  max-width: 600px;
+  text-align: center;
+}
+
+.pre-rendered-at,
+.cache-state,
+.stale-after {
+  font-size: 0.9em;
+  color: #666;
+  margin: 5px 0;
+}
+
+.cache-state.fresh {
+  color: #4caf50;
+}
+
+.cache-state.stale {
+  color: #f44336;
+}
+
+.revalidate-from {
+  margin-top: 20px;
+}
+
+.revalidate-from-button {
+  background-color: #008cba;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  padding: 10px 20px;
+  cursor: pointer;
+  transition: background-color 0.3s ease;
+}
+
+.revalidate-from-button:hover {
+  background-color: #005f73;
+}
+
+.revalidate-from-button:active {
+  transform: translateY(2px);
+}
+
+.revalidate-from-button[aria-disabled="true"] {
+  background-color: #ccc;
+  cursor: not-allowed;
+}
+
+.footer,
+.header {
+  padding: 10px;
+  position: relative;
+  place-items: center;
+  grid-auto-flow: column;
+  bottom: 0;
+  grid-gap: 20px;
+  width: 100%;
+  display: grid;
+  justify-content: center;
+}
+
+.link {
+  color: #09f;
+  text-decoration: none;
+  transition: color 0.3s ease;
+}
+
+.link:hover {
+  color: #07c;
+}
+
+@media (max-width: 768px) {
+  .widget {
+    width: 90%;
+    margin: 20px auto;
+  }
+
+  .footer {
+    padding: 20px;
+  }
+}

examples/cache-handler-redis/app/layout.tsx

@@ -0,0 +1,13 @@
+import "./global.css";
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

examples/cache-handler-redis/app/revalidate-from.tsx

@@ -0,0 +1,27 @@
+"use client";
+
+import { useFormStatus } from "react-dom";
+import revalidate from "./server-actions";
+
+function RevalidateButton() {
+  const { pending } = useFormStatus();
+
+  return (
+    <button
+      className="revalidate-from-button"
+      type="submit"
+      disabled={pending}
+      aria-disabled={pending}
+    >
+      Revalidate
+    </button>
+  );
+}
+
+export function RevalidateFrom() {
+  return (
+    <form className="revalidate-from" action={revalidate}>
+      <RevalidateButton />
+    </form>
+  );
+}

examples/cache-handler-redis/app/server-actions.ts

@@ -0,0 +1,7 @@
+"use server";
+
+import { revalidateTag } from "next/cache";
+
+export default async function revalidate() {
+  revalidateTag("time-data");
+}