Kif taħdem ir-revalidation on-demand (ISR)?

Question

Accepted Answer

**Ir-revalidation on-demand** tippermettik tinvalidaw l-paġni cached/static **eżattament meta l-data tbiddel** — minflok li tistenna intervall ibbażat fuq il-ħin. Din hija l-komplement preċiż tar-revalidation ibbażata fuq il-ħin (`revalidate: N`).

## Ibbażata fuq il-ħin vs on-demand

```tsx
// Time-based: page refreshes on a fixed schedule (may serve stale data up to N seconds)
export const revalidate = 3600; // every hour

// On-demand: refresh the INSTANT the underlying data changes — no waiting, no waste
```

Ir-revalidation ibbażata fuq il-ħin hija sempliċi imma mhux perfetta: ftit wisq = riġenerazzjoni mhux meħtieġa; wisq = kontenut qadim. On-demand issollvi dan billi ttiggera r-revalidation mill-kodiċi tiegħek meta bidla effettiva tgħodd.

## It-tnejn API on-demand

```tsx
import { revalidatePath, revalidateTag } from "next/cache";

// 1. Tag your fetches, then invalidate by tag
await fetch("https://api/posts", { next: { tags: ["posts"] } });
revalidateTag("posts");      // refresh EVERY page/fetch tagged "posts"

// 2. Or invalidate a specific path
revalidatePath("/blog/my-post");
```

## Flussu reali: webhook CMS

```ts
// app/api/revalidate/route.ts — called by your CMS when an editor publishes
import { revalidateTag } from "next/cache";
import { NextRequest, NextResponse } from "next/server";

export async function POST(req: NextRequest) {
  const secret = req.nextUrl.searchParams.get("secret");
  if (secret !== process.env.REVALIDATE_SECRET) {       // verify it's really your CMS
    return NextResponse.json({ ok: false }, { status: 401 });
  }
  revalidateTag("posts");                                // rebuild affected pages now
  return NextResponse.json({ revalidated: true });
}
```

Il-flussu: l-editor jippubblika fil-CMS → il-CMS jsejjaħ il-webhook tiegħek → `revalidateTag("posts")` tinvalidaw il-cache → l-viżitatur li jmiss ikseb HTML statiku li ġdid iġġenerat. Il-paġni jibqgħu statiku-veloċi **u** jiġu aġġornati immedjatament meta jintifrqu.

## Wara mutazzjoni Server Action

```tsx
"use server";
export async function createPost(data) {
  await db.post.create({ data });
  revalidateTag("posts"); // user sees their new post immediately
}
```

## Għaliex din hija importanti

Ir-revalidation on-demand tipprovdiluk il-holy grail: **prestazzjoni statika b'friskezza real-time**.

Minflok li taħḥas intervall ta' revalidation, inti tinvalidaw preċiżament meta l-kontenut jinbidel — permezz ta' webhook (pubblikazzjoni CMS) jew wara mutazzjonijiet Server Action — billi tuża `revalidateTag`/`revalidatePath`.

Din telimina kemm il-kontenut qadim kif ukoll ir-riġenerazzjoni eċċessiva mħassra, u tagħmel l-ISR pratika għal kontenut li jiġi aġġornat b'mod imprevedibbli.