02/frameworks

Framework Entegrasyonları

Next.js, Vite, Webpack ve Vanilla JS projelerinde SSR sunucu kodlarına dokunmadan yalnızca istemci (client) paketlerini koruma mimarisi.

Next.js (App Router & Pages Router)

Next.js projelerinde unpeek yalnızca `.next/static/chunks` dizinini hedef alır (`.next/build-manifest.json` girişlerini okur ve `globalThis.TURBOPACK.push` başlıklarını muaf tutar), `.next/server` klasörüne kesinlikle dokunmaz. Asenkron yüklenen parçalar giriş kalkanından önce çalışsa bile zehirlenmeden düzgün çözülür.

Hem `postbuild` CLI kullanımı hem de `unpeek/unplugin` eklentisi tam desteklenir.

package.json: Önerilen Next.js Postbuild Yapılandırması
{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "postbuild": "unpeek protect"
  },
  "devDependencies": {
    "unpeek": "^1.12.0"
  }
}
next.config.mjs: unplugin Webpack Entegrasyonu
import unpeek from "unpeek/unplugin";

/** @type {import('next').NextConfig} */
const nextConfig = {
  webpack(config, { dev, isServer }) {
    if (!dev && !isServer) {
      config.plugins.push(
        unpeek.webpack({
          deterrentMode: "passive",
        })
      );
    }
    return config;
  },
};

export default nextConfig;

Vite & Rollup (CLI veya unplugin)

Vite uygulamalarında `unpeek/vite`, esbuild küçültmesi sonrasındaki `enforce: 'post'` `generateBundle` kancasında çalışır ve Web Worker paketleri için `worker.plugins` ayarını otomatik bağlar.

vite.config.ts: Doğrudan Vite Eklenti Entegrasyonu
import { defineConfig } from "vite";
import unpeek from "unpeek/vite";

export default defineConfig({
  build: {
    sourcemap: true, // Postbuild aşamasında .unpeek-maps/ kasasına taşınır
  },
  plugins: [
    unpeek({
      seed: 0x9fa21b,
      minStringLength: 4,
      injectRuntimeShield: true,
      deterrentMode: "passive",
    }),
  ],
});

Webpack, Rspack & Vanilla JS Hedefleri

Webpack 5 ve Rspack eklentileri `processAssets` (`PROCESS_ASSETS_STAGE_OPTIMIZE_INLINE`) aşamasına bağlanır; esbuild `build.onEnd` (`write: false` ve `write: true`) üzerinde çalışır ve Rollup `renderChunk` içinde hash yer tutucularını yönetir. Service Worker (`sw.js`) ve Web Worker (`*.worker.js`) dosyaları `target: 'worker'` belirtilmedikçe varsayılan olarak ayrı tutulur.

webpack.config.js: Webpack Eklentisi
import unpeek from "unpeek/unplugin";

export default {
  mode: "production",
  plugins: [
    unpeek.webpack({
      deterrentMode: "passive",
      minStringLength: 5,
    }),
  ],
};