01/quickstart

Kurulum & Hızlı Başlangıç

Herhangi bir JavaScript veya TypeScript projesinde manuel AST ayarı yapmadan 30 saniye içinde unpeek korumasını etkinleştirin.

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.

Terminal: Sıfır Ayarlı Başlatma
# 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.

Terminal: Postbuild Koruma & Özet Çıktısı
# 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:

unpeek.config.ts: Yapılandırma Dosyası & Seçenekleri
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",
  },
});