Tek Komutla Kurulum (npx unpeek init)
Proje kök dizininizde `npx unpeek init` komutunu çalıştırın. CLI aracı `package.json` ve derleme dosyalarınızı inceleyerek Next.js, Vite, Webpack veya Vanilla JS yapısını otomatik tespit eder.
`package.json` dosyanıza otomatik olarak `"postbuild": "unpeek protect"` kancasını ekler ve ayrıştırılan source map dosyalarının yanlışlıkla Git'e veya genel CDN'e yüklenmemesi için `.gitignore` dosyasına `.unpeek-maps/` satırını yazar.
# 1. Proje kök dizininde başlatın
npx unpeek init
# ▛▀▀▜ unpeek 1.12.0
# ▙▄▄▟ client bundle protection
#
# PROJECT ──────────────────────────────────────
# framework next
# postbuild unpeek protect (added)
# vault .unpeek-maps/ (added)
#
# postbuild wired. maps stay private from the first build.
# run your build to protect the first bundle.Koruma Komutunu Çalıştırma (npx unpeek protect)
`npm run build` veya `pnpm build` çalıştırdığınızda `postbuild` betiği otomatik olarak `unpeek protect` işlemini tetikler. Ayrıca CI/CD hatlarında deterministik bir polimorfik tohum (`--seed`) vererek doğrudan da çalıştırabilirsiniz.
# Manuel veya postbuild üzerinden çalıştırma
npx unpeek protect --seed 482910
# ▛▀▀▜ unpeek 1.12.0
# ▙▄▄▟ client bundle protection
#
# PROJECT ──────────────────────────────────────
# framework next
# tier Tier 1 (default: <2% CPU, <15% Gzip)
# output .next/static/chunks
# bundles 18
#
# CALL GRAPH ───────────────────────────────────
# hot path exempt 24 0% tax
# cold path protected 61
#
# TRANSFORM ────────────────────────────────────
# string vault 312 literals O(1) memo
# symbol mangling 489 bindings
#
# OUTPUT ───────────────────────────────────────
# source maps 18 moved -> .unpeek-maps/
# gzip 284.12 KB -> 302.36 KB +6.42%
# elapsed 142 ms
#
# done. maps are private. hot path untouched.Proje Yapılandırması: unpeek.config.ts (defineConfig)
unpeek, otomatik çatı tespiti (framework detection) sayesinde varsayılan olarak sıfır yapılandırmayla (zero-config) çalışır. Sıcak yol (hot path) sezgilerini özelleştirmek, metin kasası (string vault) sınırlarını belirlemek veya kaynak haritası (source map) klasörünü yapılandırmak için proje kök dizinine `unpeek.config.ts` (ya da `.js`, `.mjs`, `.cjs`, `.json`) dosyası ekleyebilirsiniz.
TypeScript otomatik tamamlama (autocomplete) ve tip doğrulaması için `unpeek` paketinden `defineConfig` fonksiyonunu içe aktarın:
import { defineConfig } from "unpeek";
export default defineConfig({
// Sıcak yol sezgileri & çağrıcı yayılım muafiyetleri
hotPath: {
customAnimationCalls: ["requestAnimationFrame", "useFrame"],
customHooks: ["useSpring", "useGesture"],
maxPipelineCallers: 2,
},
// O(1) metin kasası & sözdizimi gürültü filtreleri
vault: {
minStringLength: 4,
cssFramework: "tailwind",
polymorphicDecoys: true,
},
// Sözcüksel bağlama & sembol karmaşıklaştırma kuralları
mangler: {
reservedIdentifiers: ["__NEXT_DATA__", "process"],
},
// Özel kaynak haritası çıkarma kasası
sourcemaps: {
keepPrivate: true,
vaultDir: ".unpeek-maps",
},
});