On-demand revalidation (ISR) कैसे काम करता है?

Question

Accepted Answer

**On-demand revalidation** आपको कैश किए गए/स्टैटिक पेजों को **ठीक उसी समय** अमान्य करने देता है जब डेटा बदलता है — बजाय किसी समय-आधारित अंतराल की प्रतीक्षा करने के। यह समय-आधारित ISR (`revalidate: N`) का सटीक पूरक है।

## समय-आधारित बनाम 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
```

समय-आधारित ISR सरल है लेकिन अपूर्ण: बहुत छोटा = अनावश्यक regeneration; बहुत लंबा = बासी कंटेंट। On-demand इसे ठीक करता है — जब कोई बदलाव वास्तव में होता है तब आपके अपने कोड से revalidation ट्रिगर करके।

## दो on-demand APIs

```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");
```

## एक वास्तविक workflow: CMS webhook

```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 });
}
```

प्रवाह: एडिटर CMS में publish करता है → CMS आपके webhook को कॉल करता है → `revalidateTag("posts")` कैश को अमान्य करता है → अगला विज़िटर ताज़ा रूप से regenerate किया गया स्टैटिक HTML पाता है। पेज स्टैटिक-तेज़ रहते हैं **और** publish पर तुरंत अपडेट हो जाते हैं।

## किसी Server Action mutation के बाद

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

## यह क्यों महत्वपूर्ण है

On-demand revalidation आपको वह आदर्श स्थिति देता है: **स्टैटिक performance के साथ रियल-टाइम ताज़गी**।

किसी revalidation अंतराल का अनुमान लगाने के बजाय, आप ठीक उसी समय अमान्य करते हैं जब कंटेंट बदलता है — webhooks (CMS publish) के माध्यम से या Server Action mutations के बाद — `revalidateTag`/`revalidatePath` का उपयोग करके।

यह बासी कंटेंट और फ़िज़ूल over-regeneration दोनों को समाप्त करता है, जिससे अप्रत्याशित रूप से अपडेट होने वाले कंटेंट के लिए ISR व्यावहारिक बन जाता है।