როგორ მუშაობს on-demand revalidation (ISR)?

Question

Accepted Answer

**On-demand revalidation** გაძლევთ საშუალებას გა無효화 cached/static გვერდებს **ზუსტად მაშინ, როდესაც მონაცემები იცვლება** — ვიდრე დროზე დაფუძნებული ინტერვალის გადაცდენას. ეს არის დროზე დაფუძნებული ISR-ის (`revalidate: N`) ზუსტი დამატება.

## დროზე დაფუძნებული 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
```

დროზე დაფუძნებული ISR მარტივია, მაგრამ არასრულყოფილი: ძალიან მოკლე = არასაჭირო გენერირება; ძალიან გრძელი = მოძველებული ინფორმაცია. On-demand აჭრის ამას მეშვეობით revalidation-ის ჩართვა თქვენი კოდიდან, როდესაც ცვლილება რეალურად ხდება.

## ორი on-demand API

```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")` გაუფასურებს cache-ს → შემდეგი ვიზიტორი იღებს ახლად გენერირებულ static HTML-ს. გვერდები რჩება static-სწრაფი **და** განახლდება დაუყოვნებლივ გამოქვეყნებისას.

## 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 გაძლევთ სამოლოდინო: **static ფორმატობა real-time სიახლით**.

revalidation ინტერვალის გამოცნობის ნაცვლად, თქვენ გაუფასურებთ ზუსტად მაშინ, როდესაც ინფორმაცია იცვლება — webhooks (CMS გამოქვეყნება) ან Server Action mutations შემდეგ — `revalidateTag`/`revalidatePath` გამოყენებით.

ეს აღმოფხვრის მოძველებულ ინფორმაციას და აკრძალვის სიკეთის გადახარჯვას, რაც ISR-ს პრაქტიკულს ხდის იმ კონტენტზე, რომელიც არაპროგნოზირებელი ხდება.