آن ڈیمانڈ ریویلیڈیشن (ISR) کیسے کام کرتا ہے؟

Question

Accepted Answer

**آن ڈیمانڈ ریویلیڈیشن** آپ کو کیشڈ/سٹیٹک صفحات کو **بالکل وقت پر غلط ثابت کرنے** دیتی ہے جب ڈیٹا بدلتا ہے — بجائے وقت کی بنیاد پر وقفہ کے انتظار کے۔ یہ وقت کی بنیاد پر ISR کی درست تکمیل ہے (`revalidate: N`)۔

## وقت کی بنیاد پر بمقابلہ آن ڈیمانڈ

```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 سادہ ہے لیکن ناقص ہے: بہت کم = غیر ضروری دوبارہ جنریشن؛ بہت زیادہ = پرانا مواد۔ آن ڈیمانڈ یہ ٹھیک کرتا ہے اپنی کوڈ سے ریویلیڈیشن کو متحرک کرکے جب کوئی تبدیلی واقعی ہو۔

## دونوں آن ڈیمانڈ 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");
```

## ایک حقیقی ورک فلو: 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 میں شائع کرتا ہے → CMS آپ کے webhook کو کال کرتا ہے → `revalidateTag("posts")` کیش کو غلط ثابت کرتا ہے → اگلا زائر نیا جنریٹ شدہ سٹیٹک HTML حاصل کرتا ہے۔ صفحات سٹیٹک تیز رہتے ہیں **اور** شائع کرتے وقت فوری طور پر اپ ڈیٹ ہوتے ہیں۔

## Server Action میوٹیشن کے بعد

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

## یہ اہم کیوں ہے

آن ڈیمانڈ ریویلیڈیشن آپ کو مقدس کنجی دیتی ہے: **سٹیٹک کارکردگی حقیقی وقت کی تازگی کے ساتھ**۔

ریویلیڈیشن وقفہ کا اندازہ لگانے کی بجائے، آپ بالکل غلط ثابت کرتے ہیں جب مواد بدلتا ہے — webhooks کے ذریعے (CMS شائع) یا Server Action میوٹیشن کے بعد — `revalidateTag`/`revalidatePath` استعمال کرتے ہوئے۔

یہ پرانے مواد اور بیکار زیادہ جنریشن دونوں کو ختم کرتا ہے، ISR کو بہترین بناتے ہوئے ایسے مواد کے لیے جو غیر متوقع طور پر اپ ڈیٹ ہوتا ہے۔