Giriş: Edge Computing Devri

2026'da Astro 5.0, edge runtime desteği ile Vercel Edge Functions ve Cloudflare Workers gibi servislerle doğal entegrasyon sağlıyor. Statik sayfalar, dinamik sunucu fonksiyonları ve edge hesaplamasını tek framework'te yönetebilirsin.

1. Astro Server Functions ile API Uç Noktası

// src/routes/api/ads/[id].ts
import type { APIRoute } from 'astro';

export const prerender = false;
export const runtime = 'edge';

export const GET: APIRoute = async ({ params }) => {
  try {
    const { id } = params;

    if (!id) {
      return new Response(
        JSON.stringify({ error: 'Ad ID gerekli' }),
        { status: 400, headers: { 'Content-Type': 'application/json' } }
      );
    }

    const ad = await fetch(`/api/database/ads/${id}`).then(r => r.json());
    
    if (!ad) {
      return new Response(
        JSON.stringify({ error: 'Reklam bulunamadı' }),
        { status: 404, headers: { 'Content-Type': 'application/json' } }
      );
    }

    return new Response(
      JSON.stringify({
        ...ad,
        ctr: (ad.clicks / ad.impressions * 100).toFixed(2),
        fetched_at: new Date().toISOString(),
      }),
      {
        status: 200,
        headers: {
          'Content-Type': 'application/json',
          'Cache-Control': 'public, max-age=60',
        },
      }
    );
  } catch (error) {
    console.error('Ad API error:', error);
    return new Response(
      JSON.stringify({ error: 'Sunucu hatası' }),
      { status: 500, headers: { 'Content-Type': 'application/json' } }
    );
  }
};

2. Edge Runtime ile Coğrafi Yönlendirme

// src/middleware.ts
import { defineMiddleware } from 'astro:middleware';

export const onRequest = defineMiddleware(async (context, next) => {
  const country = context.request.headers.get('cf-ipcountry') || 'US';
  
  context.locals.country = country;
  context.locals.currency = getCurrencyByCountry(country);

  return next();
});

function getCurrencyByCountry(country: string): string {
  const currencyMap: Record<string, string> = {
    'TR': 'TRY',
    'US': 'USD',
    'GB': 'GBP',
    'DE': 'EUR',
    'JP': 'JPY',
  };
  return currencyMap[country] || 'USD';
}

3. Astro 5.0 Hibrit Sayfa (Parametre Kontrolü ile)

---
// src/pages/products/[id].astro
import Layout from '@/layouts/Layout.astro';

export const prerender = false;
export const runtime = 'edge';

const { id } = Astro.params;

// ✅ DÜZELTME: id validation eklendi
if (!id) {
  return Astro.redirect('/404');
}

const product = await getProduct(id);

if (!product) {
  return Astro.redirect('/404');
}

Astro.response.headers.set(
  'Cache-Control',
  'public, max-age=3600, s-maxage=86400'
);

async function getProduct(id: string) {
  try {
    const response = await fetch(`/api/products/${id}`);
    if (!response.ok) return null;
    return response.json();
  } catch {
    return null;
  }
}
---

<Layout title={product.name}>
  <div class="container mx-auto py-8">
    <h1>{product.name}</h1>
    <p>{product.description}</p>
    <span class="text-2xl font-bold">₺{product.price}</span>
  </div>
</Layout>

4. Astro Config

// astro.config.ts
import { defineConfig } from 'astro/config';
import cloudflare from '@astrojs/cloudflare';

export default defineConfig({
  adapter: cloudflare({ mode: 'directory' }),
  output: 'hybrid',
  vite: {
    ssr: {
      noExternal: ['firebase/app', 'firebase/firestore'],
    },
  },
});

5. Edge vs Node Mimarisi (Timeout Farkı)

Edge (Cloudflare Workers): API çağrıları, durumsuz (stateless) işlemler, ~10ms latensi, 30 saniyelik timeout.
Node.js (Origin): Veritabanı bağlantıları, Firestore realtime listeners, uzun süreli işlemler.
Cache Stratejisi: Kısa max-age, geniş s-maxage kombinasyonu.
Realtime Listeners: Firebase onSnapshot vb. edge'de çalışmaz, Node.js ortamında kullanılmalıdır.

Özet

Astro 5.0 ile edge computing üzerinden coğrafi olarak dağıtılmış, ultra-düşük latensili ve parametre validasyonu yapılmış web uygulamaları geliştirilebilir.