Рендеринг у Next.js: SSG, SSR та ISR

// ============================================================================
// ЧАСТИНА 1: Next.js 16 Route Handler (app/api/revalidate/route.ts)
// ============================================================================

import { NextRequest, NextResponse } from 'next/server';
import { revalidateTag } from 'next/cache';
import crypto from 'node:crypto';

interface RevalidatePayload {
tag?: string;
slug?: string;
id?: number;
timestamp: number;
}

/**
* Безпечна перевірка підпису HMAC-SHA256 із захистом від Timing Attacks.
*/
function verifyHmacSignature(rawBody: string, signatureHeader: string | null, secret: string): boolean {
if (!signatureHeader || !secret) {
  return false;
}

const expectedSignature = crypto
  .createHmac('sha256', secret)
  .update(rawBody)
  .digest('hex');

const trustedBuffer = Buffer.from(expectedSignature, 'utf8');
const userBuffer = Buffer.from(signatureHeader, 'utf8');

if (trustedBuffer.length !== userBuffer.length) {
  return false;
}

return crypto.timingSafeEqual(trustedBuffer, userBuffer);
}

export async function POST(request: NextRequest): Promise<NextResponse> {
const secret = process.env.REVALIDATION_SECRET;
if (!secret) {
  console.error('[Revalidate] REVALIDATION_SECRET is not configured on edge.');
  return NextResponse.json({ message: 'Server configuration error' }, { status: 500 });
}

try {
  const rawBody = await request.text();
  const signature = request.headers.get('X-Agentic-Signature');

  // 1. Криптографічна валідація джерела
  if (!verifyHmacSignature(rawBody, signature, secret)) {
    return NextResponse.json({ message: 'Invalid cryptographic signature' }, { status: 401 });
  }

  const payload = JSON.parse(rawBody) as RevalidatePayload;

  // 2. Захист від Replay-атак (вікно 5 хвилин)
  const now = Math.floor(Date.now() / 1000);
  if (Math.abs(now - payload.timestamp) > 300) {
    return NextResponse.json({ message: 'Timestamp outside acceptable window' }, { status: 400 });
  }

  const tagsToPurge: string[] = [];

  if (payload.tag) {
    tagsToPurge.push(payload.tag);
  }
  if (payload.id) {
    tagsToPurge.push(`post:${payload.id}`);
  }
  if (payload.slug) {
    tagsToPurge.push(`post:${payload.slug}`);
  }

  // Завжди інвалідуємо загальний список публікацій
  tagsToPurge.push('posts');

  // 3. Атомарне скидання тегів у Data Cache Next.js
  for (const tag of tagsToPurge) {
    revalidateTag(tag);
  }

  return NextResponse.json({
    revalidated: true,
    purgedTags: tagsToPurge,
    timestamp: Date.now(),
  });
} catch (error) {
  console.error('[Revalidate] Error processing webhook:', error);
  return NextResponse.json({ message: 'Error parsing request body' }, { status: 400 });
}
}

// ============================================================================
// ЧАСТИНА 2: WordPress Dispatcher (wp-content/mu-plugins/agentic-revalidation.php)
// Код на PHP 8.4+ для відправки підписаних вебхуків із ядра WordPress:
// ============================================================================
/*
<?php
declare(strict_types=1);

namespace AgenticLab\Integration;

final class AgenticRevalidationDispatcher {
  private const string REVALIDATE_URL = 'https://frontend.agenticlab.com/api/revalidate';

  public static function init(): void {
      add_action('transition_post_status', [self::class, 'handle_status_transition'], 10, 3);
      add_action('wp_trash_post', [self::class, 'handle_post_deletion'], 10, 1);
  }

  public static function handle_status_transition(string $new_status, string $old_status, \WP_Post $post): void {
      // Спрацьовує тільки при публікації, оновленні або знятті з публікації
      if ($new_status !== 'publish' && $old_status !== 'publish') {
          return;
      }

      if (wp_is_post_revision($post->ID) || wp_is_post_autosave($post->ID)) {
          return;
      }

      self::dispatch_revalidation([
          'id'        => $post->ID,
          'slug'      => $post->post_name,
          'tag'       => 'post:' . $post->ID,
          'timestamp' => time(),
      ]);
  }

  public static function handle_post_deletion(int $post_id): void {
      self::dispatch_revalidation([
          'id'        => $post_id,
          'tag'       => 'post:' . $post_id,
          'timestamp' => time(),
      ]);
  }

  private static function dispatch_revalidation(array $payload): void {
      $secret = defined('NEXTJS_REVALIDATION_SECRET') ? NEXTJS_REVALIDATION_SECRET : '';
      if (empty($secret)) {
          return;
      }

      $json_payload = wp_json_encode($payload);
      $signature = hash_hmac('sha256', $json_payload, $secret);

      wp_remote_post(self::REVALIDATE_URL, [
          'method'      => 'POST',
          'timeout'     => 5,
          'blocking'    => false, // Не блокуємо адмінку WP, відправка асинхронна!
          'headers'     => [
              'Content-Type'        => 'application/json',
              'X-Agentic-Signature' => $signature,
          ],
          'body'        => $json_payload,
      ]);
  }
}

add_action('init', [AgenticRevalidationDispatcher::class, 'init']);
*/